kips

kips is a personal data management server that surfaces data management tools for LLMs and a basic CLI to interact with a SQLite database. It can store passwords and usernames (auth), notes, conversations, tasks, and tags, with join tables noting the relationships between notes, conversations, tasks, and their tags. Start the server with npx kips to initialize the database, then use the provided import commands to ingest data (auth, notes, conversations, tasks) and assign tags. The server also exposes a config command (npx kips config) that integrates with Claude Desktop, allowing Claude to query, insert, or update the database as a set of MCP resources. In Claude Desktop, you’ll see the MCP server listed with accessible schemas as attachable resources you can connect to in order to read or modify data.

Prerequisites:

• Node.js and npm installed on your machine
• Internet access to fetch the kips package via npm

Installation steps:

1. Verify Node.js and npm are installed: node -v npm -v

2. You don’t typically install kips globally; instead, use npx to run it directly from the registry: npx kips

3. If you want to ensure the package is available locally for development, you can initialize a project folder and install via npm: mkdir kips-project && cd kips-project npm init -y npm i kips --save-dev

4. To start using kips, simply run the commands shown in the usage section (they use npx kips): npx kips

5. After the first run, you can import data and configure Claude Desktop integration as described below.

Notes and tips:

• The server uses SQLite as its data store. The first run initializes the database schema.
• Import commands expect specific data formats (e.g., auth via CSV with url, username/email, password, notes; notes/tasks/conversations with appropriate fields).
• Tags are supported and can be attached during import; related join tables include noteTag, conversationTag, and taskTag.
• Claude Desktop integration is via the config command (npx kips config). After running config, the MCP server should appear in Claude Desktop (usually after a restart) with resource icons for each applicable schema.
• If you encounter issues with importing data, double-check CSV headers and ensure the paths to your CSV/text files are correct.
• For development, you can run commands directly through Node (as shown in the development examples in the README) using node ./build/index.js <command> if you build locally.