{"id":22845170,"url":"https://github.com/hdresearch/kips","last_synced_at":"2025-05-07T02:40:29.638Z","repository":{"id":267354287,"uuid":"898137802","full_name":"hdresearch/kips","owner":"hdresearch","description":"Personal data storage for MCP clients like Claude Desktop.","archived":false,"fork":false,"pushed_at":"2024-12-11T00:09:14.000Z","size":43,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-31T05:28:39.623Z","etag":null,"topics":["claude","database","model-context-protocol","sqlite"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hdresearch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-03T21:20:12.000Z","updated_at":"2024-12-12T16:41:33.000Z","dependencies_parsed_at":"2024-12-09T21:34:19.667Z","dependency_job_id":"a06ce050-5193-4580-9fd3-000b8b6ca7ab","html_url":"https://github.com/hdresearch/kips","commit_stats":null,"previous_names":["hdresearch/kips"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hdresearch%2Fkips","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hdresearch%2Fkips/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hdresearch%2Fkips/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hdresearch%2Fkips/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hdresearch","download_url":"https://codeload.github.com/hdresearch/kips/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252802314,"owners_count":21806473,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude","database","model-context-protocol","sqlite"],"created_at":"2024-12-13T03:15:57.929Z","updated_at":"2025-05-07T02:40:29.613Z","avatar_url":"https://github.com/hdresearch.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# kips\n\nPersonal data management server. Integrates with Claude Desktop and other MCP clients.\n\n## Usage\n\nkips drives a SQLite database and surfaces tools for LLMs as well as a basic CLI for interacting with the database.\n\nYou can store `auth` (passwords and usernames), `note`s, `conversation`s, `task`s (leftover work to do from last time) and of course `tag`s. \n\nNotes, conversations and tasks have join tables with tags under `noteTag`, `conversationTag` and `taskTag`.\n\nJust run it normally first to init the database:\n\n```bash\nnpx kips\n```\n\nThen ingest data:\n\n```bash\n## passwords in csv files\nnpx kips import --type auth ~/passwords.csv\n## notes and tags\nnpx kips import --type note ~/note.txt --tag \"big-deal another-tag\"\n## conversations in the past\nnpx kips import --type conversation ~/claudechat.txt --tag \"therapy\"\n## agentic tasks that aren't done yet\nnpx kips import --type task ~/tasks.csv --tag \"therapy revenge\"\n```\n\nIntegrate it into Claude Desktop to let Claude query, insert or update the database by running the `config` command:\n\n```bash\nnpx kips config\n```\n\nYou'll then be able to see the MCP server in Claude Desktop (usually after restart) with the hammer icon, and all applicable tables as resources you can \"connect\" with the plug icon.\n\n### Expected formats\n\nThe csv imports expect specific headers in order to be useful.\n\n#### Auth\n\nWe expect a .csv file with `url`, `username` **or** `email` (both can exist, but email takes precedence), `password` and `notes` columns. All other columns are ignored.\n\n#### Tasks\n\nWe expect a .csv file with `objective`, `progressAssessment` and `completed` columns. `completed` is a boolean.\n\n### Usage with Claude Desktop\n\nAll operations are specified for MCP clients and all schemas are exposed as attachable resources. If you have more complex files (screenshots, PDFs) you can get Claude to read and transcribe it direct to the database. At present, you'll need to attach all schemas you intend to use or Claude will have to look up the schema again before applying an operation.\n\n## Development\n\nYou'll want the Claude integration to use your local script.\n\n```bash\n## get it installed and built\nnpm run build\n## now configure it to use the local build\nnode ./build/index.js config --debug\n```\n\nLikewise, when developing you can either `npm link` to use your local install as an npx package or just call the script direct:\n\n```bash\n## eg, using the prior example\nnode ./build/index.js import --type task ~/tasks.csv --tag \"therapy revenge\"\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhdresearch%2Fkips","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhdresearch%2Fkips","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhdresearch%2Fkips/lists"}