Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Memos MCP Server List all memos from my personal instance"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A Model Context Protocol (MCP) server for Memos, enabling AI assistants to interact with your Memos instances.
๐ Multi-Instance Support: Connect to multiple Memos instances and query them individually or collectively
๐ Note Management: Create, read, update, and delete memos with full Markdown support
๐ท๏ธ Tag Management: List and manage tags across your memos
๐ Attachment Support: Upload and manage file attachments
๐ Shortcuts: Create and manage saved filters
๐ Secure Storage: API keys are stored locally in your configuration directory
๐๏ธ Tiered Tool Exposure: Control which tools are enabled to minimize context usage
Related MCP server: Memos MCP Server
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"memos": {
"command": "npx",
"args": ["-y", "@0xlimao/memos-mcp-server"]
}
}
}The server supports three tiers of tools to minimize context usage:
Tier | Flag | Description |
Tier 1 | (default) | Core note-taking tools |
Tier 2 |
| User advanced features (PAT, webhooks) |
Tier 3 |
| Instance administration |
All |
| All tools enabled |
Example configurations:
// Default: Only note-taking tools
{
"command": "npx",
"args": ["-y", "@0xlimao/memos-mcp-server"]
}
// With user advanced tools
{
"command": "npx",
"args": ["-y", "@0xlimao/memos-mcp-server", "--user-tools"]
}
// With admin tools
{
"command": "npx",
"args": ["-y", "@0xlimao/memos-mcp-server", "--admin-tools"]
}
// All tools
{
"command": "npx",
"args": ["-y", "@0xlimao/memos-mcp-server", "--full-tools"]
}Instance configurations are stored at:
macOS/Linux: ~/.config/memos-mcp/instances.json
Windows: %APPDATA%\memos-mcp\instances.json
Tool | Description |
| Connect to a new Memos instance |
| Remove a connected instance |
| List all connected instances |
| List memos with optional filtering |
| Get a specific memo by ID |
| Create a new memo |
| Update an existing memo |
| Delete a memo |
| List all tags |
| List saved shortcuts |
| Create a new shortcut |
| Update a shortcut |
| Delete a shortcut |
| List attachments |
| Upload a new attachment |
| Delete an attachment |
Tool | Description |
| List PATs for a user |
| Create a new PAT |
| Delete a PAT |
| List webhooks for a user |
| Create a new webhook |
| Update a webhook |
| Delete a webhook |
| Get user settings |
| Update user settings |
| List all user settings |
| List user notifications |
| Update a notification |
| Delete a notification |
Tool | Description |
| List all users |
| Get a specific user by ID or username |
| Create a new user |
| Update a user |
| Delete a user |
| Get instance information |
| Get instance settings |
| Update instance settings |
| List activities |
| Get a specific activity |
"Connect to my Memos instance at https://memos.example.com with the API key abc123"
The AI will use the connect_instance tool to save the connection:
Host: https://memos.example.com
Name: A friendly name (e.g., personal, work)
API Key: Your access token from Memos โ Settings โ My Account โ Access Tokens
"Find all memos containing 'project ideas' in all my memos instances"
The server will query all connected instances and return matching results.
"Create a new memo in my work-memos instance about the meeting today"
The server will create the memo only in the specified instance.
"List all archived memos with the #important tag"
The server supports CEL filter expressions for advanced queries.
# Clone the repository
git clone https://github.com/flyinglimao/mcp-server-memos.git
cd mcp-server-memos
# Install dependencies
pnpm install
# Run in development mode
pnpm run dev
# Run tests
pnpm test
# Lint code
pnpm run lint
# Format code
pnpm run formatMIT License - see LICENSE for details.
Contributions are welcome! Please read our contributing guidelines before submitting PRs.
Connect to a Memos instance. Saves the connection info for future use.
Inputs: host (required), name (required), apiKey (required).
Create a new memo.
Inputs: content (required), instance (required), pinned, visibility.
Create a new shortcut (saved filter).
Inputs: title (required), filter (required), instance (required), user.
Delete an attachment.
Inputs: instance (required), attachmentName (required).
Delete a memo.
Inputs: instance (required), memoName (required).
Delete a shortcut.
Inputs: instance (required), shortcutName (required).
Remove a connected Memos instance.
Inputs: name (required).
Get a specific memo by its name.
Inputs: instance (required), memoName (required).
List all attachments.
Inputs: instance (required).
List all connected Memos instances.
Inputs: no named parameters.
List memos from one or all connected Memos instances.
Inputs: state, filter, orderBy, instance, +1 more.
List all shortcuts for a user.
Inputs: instance (required), user.
List all tags from memos.
Inputs: instance.
Update an existing memo.
Inputs: instance (required), memoName (required), state, pinned, +2 more.
Update an existing shortcut.
Inputs: instance (required), shortcutName (required), title, filter.
Upload a new attachment.
Inputs: type (required), content (required), filename (required), instance (required), +1 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
Scored across 16 tools
Each tool targets a distinct resource and action: instance management, memo CRUD, tags, shortcuts, and attachments are clearly separated. Even the list_* tools are unambiguous because the resource type is explicit in each name.
All tool names follow a consistent verb_noun snake_case pattern, such as list_memos, create_memo, update_shortcut, and upload_attachment. The only slight deviation is get_memo instead of list_memo, but this is still consistent with standard CRUD naming.
With 16 tools, the set is slightly above the ideal 3-15 range but still well-scoped for a server covering instances, memos, tags, shortcuts, and attachments. Each tool covers a needed operation, so the count feels justified rather than bloated.
Core memo lifecycle, instance management, shortcut CRUD, and attachment operations are well covered. Minor gaps exist, such as no attachment download/retrieval endpoint and no single get_shortcut operation, but agents can mostly work around these using list operations.
Securely search, create, and organize your Mem notes and collections from AI assistants.
Connect AI to your flomo notes. Search, create, edit notes and manage tags via MCP.
Search, read, create and edit your Memol notes from Claude. Team note-taking with AI search.
Portable AI memory you own. Keep memories and notes across Claude, ChatGPT, and other AI tools.
