{"_id":"@0xlimao/memos-mcp-server","_rev":"2-4ad7bdef99855574aaf99e284611952f","name":"@0xlimao/memos-mcp-server","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@0xlimao/memos-mcp-server","version":"0.1.0","keywords":["mcp","memos","ai","notes","model-context-protocol","claude"],"author":"","license":"MIT","_id":"@0xlimao/memos-mcp-server@0.1.0","maintainers":[{"name":"flyinglimao","email":"hi@limaois.me"}],"homepage":"https://github.com/flyinglimao/mcp-server-memos#readme","bugs":{"url":"https://github.com/flyinglimao/mcp-server-memos/issues"},"bin":{"memos-mcp":"dist/index.js"},"dist":{"shasum":"9f9f5f8548afd204a143be87e10a4795de9016ff","tarball":"https://registry.npmjs.org/@0xlimao/memos-mcp-server/-/memos-mcp-server-0.1.0.tgz","fileCount":123,"integrity":"sha512-McpI+zEn2PQWw+5uYE3AZfuV0y/rGuCUGbJhPpmRBG/vlXmvbljnCgfakjRLtOrLPVBnR/YXQ6PJFNeWQeKaMw==","signatures":[{"sig":"MEUCIA78RJb5izNFyZ8efoZlNohSuj9fhSAjnIK8fAFEbuoXAiEAiJoSlhP786YXw2jqTPLIyhTk+t5KpvGRShADB5Uc578=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":183846},"main":"dist/index.js","type":"module","_from":"file:0xlimao-memos-mcp-server-0.1.0.tgz","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src/","test":"echo \"No tests yet\" && exit 0","build":"tsc","start":"node dist/index.js","format":"prettier --write src/","lint:fix":"eslint src/ --fix","typecheck":"tsc --noEmit","test:tools":"npx tsx tests/test-tools.ts","format:check":"prettier --check src/"},"_npmUser":{"name":"flyinglimao","email":"hi@limaois.me"},"_resolved":"/private/var/folders/jw/knppc_9x64ggv4shvcn020lm0000gn/T/a08bfc029321e0c7950a5ea43c5356d4/0xlimao-memos-mcp-server-0.1.0.tgz","_integrity":"sha512-McpI+zEn2PQWw+5uYE3AZfuV0y/rGuCUGbJhPpmRBG/vlXmvbljnCgfakjRLtOrLPVBnR/YXQ6PJFNeWQeKaMw==","repository":{"url":"git+https://github.com/flyinglimao/mcp-server-memos.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for Memos - a privacy-focused note-taking application","directories":{},"_nodeVersion":"25.2.1","dependencies":{"zod":"^4.3.5","@modelcontextprotocol/sdk":"^1.25.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","eslint":"^9.39.2","prettier":"^3.7.4","@eslint/js":"^9.39.2","typescript":"^5.9.3","@types/node":"^25.0.3","typescript-eslint":"^8.51.0"},"_npmOperationalInternal":{"tmp":"tmp/memos-mcp-server_0.1.0_1767577907546_0.27133439635497036","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@0xlimao/memos-mcp-server","version":"0.1.1","description":"MCP server for Memos - a privacy-focused note-taking application","type":"module","main":"dist/index.js","bin":{"memos-mcp":"dist/index.js"},"keywords":["mcp","memos","ai","notes","model-context-protocol","claude"],"author":"","license":"MIT","repository":{"type":"git","url":"git+https://github.com/flyinglimao/mcp-server-memos.git"},"bugs":{"url":"https://github.com/flyinglimao/mcp-server-memos/issues"},"homepage":"https://github.com/flyinglimao/mcp-server-memos#readme","engines":{"node":">=18.0.0"},"publishConfig":{"access":"public","provenance":true},"dependencies":{"@modelcontextprotocol/sdk":"^1.25.1","zod":"^4.3.5"},"devDependencies":{"@eslint/js":"^9.39.2","@types/node":"^25.0.3","eslint":"^9.39.2","prettier":"^3.7.4","tsx":"^4.21.0","typescript":"^5.9.3","typescript-eslint":"^8.51.0"},"scripts":{"build":"tsc","dev":"tsx watch src/index.ts","start":"node dist/index.js","lint":"eslint src/","lint:fix":"eslint src/ --fix","format":"prettier --write src/","format:check":"prettier --check src/","typecheck":"tsc --noEmit","test":"echo \"No tests yet\" && exit 0","test:tools":"npx tsx tests/test-tools.ts"},"types":"./dist/index.d.ts","_id":"@0xlimao/memos-mcp-server@0.1.1","_integrity":"sha512-z8Bsdp+bllU/tFDCgZp7lKbWHBLmOKbeAJFaJ7ToJjypaopDLg3/BptubRacnD0UrLqTtdTXK7zEwHGE4CMd+w==","_resolved":"/tmp/43008d2d469bf0e08864e4e3b58d25b1/0xlimao-memos-mcp-server-0.1.1.tgz","_from":"file:0xlimao-memos-mcp-server-0.1.1.tgz","_nodeVersion":"24.12.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-z8Bsdp+bllU/tFDCgZp7lKbWHBLmOKbeAJFaJ7ToJjypaopDLg3/BptubRacnD0UrLqTtdTXK7zEwHGE4CMd+w==","shasum":"a8311285bebcbd97fb6e1739dc781ba2187da5b9","tarball":"https://registry.npmjs.org/@0xlimao/memos-mcp-server/-/memos-mcp-server-0.1.1.tgz","fileCount":123,"unpackedSize":183767,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@0xlimao%2fmemos-mcp-server@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFPK3lYCmsFkYDDg0WE6CV2D0DH+PYtwXUa0+JgCOFYbAiBjJ9gr0LjJudPjeec0noSVMCqc2nsP+lfhLtYh8+/kqg=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3b56896b-14e0-41ff-aa58-10917d087f57"}},"directories":{},"maintainers":[{"name":"flyinglimao","email":"hi@limaois.me"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/memos-mcp-server_0.1.1_1767580576833_0.19050121056936953"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-05T01:51:47.447Z","modified":"2026-01-05T02:36:17.361Z","0.1.0":"2026-01-05T01:51:47.701Z","0.1.1":"2026-01-05T02:36:16.984Z"},"bugs":{"url":"https://github.com/flyinglimao/mcp-server-memos/issues"},"license":"MIT","homepage":"https://github.com/flyinglimao/mcp-server-memos#readme","keywords":["mcp","memos","ai","notes","model-context-protocol","claude"],"repository":{"type":"git","url":"git+https://github.com/flyinglimao/mcp-server-memos.git"},"description":"MCP server for Memos - a privacy-focused note-taking application","maintainers":[{"name":"flyinglimao","email":"hi@limaois.me"}],"readme":"# Memos MCP Server\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for [Memos](https://github.com/usememos/memos), enabling AI assistants to interact with your Memos instances.\n\n## Features\n\n- 🔗 **Multi-Instance Support**: Connect to multiple Memos instances and query them individually or collectively\n- 📝 **Note Management**: Create, read, update, and delete memos with full Markdown support\n- 🏷️ **Tag Management**: List and manage tags across your memos\n- 📎 **Attachment Support**: Upload and manage file attachments\n- 🔖 **Shortcuts**: Create and manage saved filters\n- 🔒 **Secure Storage**: API keys are stored locally in your configuration directory\n- 🎚️ **Tiered Tool Exposure**: Control which tools are enabled to minimize context usage\n\n## Usage\n\n### With Claude Desktop\n\nAdd to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"memos\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@0xlimao/memos-mcp-server\"]\n    }\n  }\n}\n```\n\n### Tool Tiers\n\nThe server supports three tiers of tools to minimize context usage:\n\n| Tier | Flag | Description |\n|------|------|-------------|\n| **Tier 1** | (default) | Core note-taking tools |\n| **Tier 2** | `--user-tools` | User advanced features (PAT, webhooks) |\n| **Tier 3** | `--admin-tools` | Instance administration |\n| **All** | `--full-tools` | All tools enabled |\n\nExample configurations:\n\n```json\n// Default: Only note-taking tools\n{\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"@0xlimao/memos-mcp-server\"]\n}\n\n// With user advanced tools\n{\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"@0xlimao/memos-mcp-server\", \"--user-tools\"]\n}\n\n// With admin tools\n{\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"@0xlimao/memos-mcp-server\", \"--admin-tools\"]\n}\n\n// All tools\n{\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"@0xlimao/memos-mcp-server\", \"--full-tools\"]\n}\n```\n\n### Configuration File Location\n\nInstance configurations are stored at:\n- **macOS/Linux**: `~/.config/memos-mcp/instances.json`\n- **Windows**: `%APPDATA%\\memos-mcp\\instances.json`\n\n## Available Tools\n\n### Tier 1: Core Tools (Default)\n\n| Tool | Description |\n|------|-------------|\n| `connect_instance` | Connect to a new Memos instance |\n| `disconnect_instance` | Remove a connected instance |\n| `list_instances` | List all connected instances |\n| `list_memos` | List memos with optional filtering |\n| `get_memo` | Get a specific memo by ID |\n| `create_memo` | Create a new memo |\n| `update_memo` | Update an existing memo |\n| `delete_memo` | Delete a memo |\n| `list_tags` | List all tags |\n| `list_shortcuts` | List saved shortcuts |\n| `create_shortcut` | Create a new shortcut |\n| `update_shortcut` | Update a shortcut |\n| `delete_shortcut` | Delete a shortcut |\n| `list_attachments` | List attachments |\n| `upload_attachment` | Upload a new attachment |\n| `delete_attachment` | Delete an attachment |\n\n### Tier 2: User Advanced Tools (--user-tools)\n\n| Tool | Description |\n|------|-------------|\n| `list_personal_access_tokens` | List PATs for a user |\n| `create_personal_access_token` | Create a new PAT |\n| `delete_personal_access_token` | Delete a PAT |\n| `list_webhooks` | List webhooks for a user |\n| `create_webhook` | Create a new webhook |\n| `update_webhook` | Update a webhook |\n| `delete_webhook` | Delete a webhook |\n| `get_user_setting` | Get user settings |\n| `update_user_setting` | Update user settings |\n| `list_user_settings` | List all user settings |\n| `list_notifications` | List user notifications |\n| `update_notification` | Update a notification |\n| `delete_notification` | Delete a notification |\n\n### Tier 3: Admin Tools (--admin-tools)\n\n| Tool | Description |\n|------|-------------|\n| `list_users` | List all users |\n| `get_user` | Get a specific user by ID or username |\n| `create_user` | Create a new user |\n| `update_user` | Update a user |\n| `delete_user` | Delete a user |\n| `get_instance_profile` | Get instance information |\n| `get_instance_setting` | Get instance settings |\n| `update_instance_setting` | Update instance settings |\n| `list_activities` | List activities |\n| `get_activity` | Get a specific activity |\n\n## Examples\n\n### Connecting to a Memos Instance\n\n> \"Connect to my Memos instance at https://memos.example.com with the API key abc123\"\n\nThe AI will use the `connect_instance` tool to save the connection:\n- **Host**: `https://memos.example.com`\n- **Name**: A friendly name (e.g., `personal`, `work`)\n- **API Key**: Your access token from Memos → Settings → My Account → Access Tokens\n\n### Searching Across All Instances\n\n> \"Find all memos containing 'project ideas' in all my memos instances\"\n\nThe server will query all connected instances and return matching results.\n\n### Querying a Specific Instance\n\n> \"Create a new memo in my work-memos instance about the meeting today\"\n\nThe server will create the memo only in the specified instance.\n\n### Using Filters\n\n> \"List all archived memos with the #important tag\"\n\nThe server supports CEL filter expressions for advanced queries.\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/flyinglimao/mcp-server-memos.git\ncd mcp-server-memos\n\n# Install dependencies\npnpm install\n\n# Run in development mode\npnpm run dev\n\n# Run tests\npnpm test\n\n# Lint code\npnpm run lint\n\n# Format code\npnpm run format\n```\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Contributing\n\nContributions are welcome! Please read our contributing guidelines before submitting PRs.\n","readmeFilename":"README.md"}