Memos MCP Server

A Model Context Protocol (MCP) server for interacting with Memos - a lightweight, open-source memo hub.

Features

• Complete Memo Management: Create, read, update, and delete memos
• Tag Support: List, create, and manage tags
• Flexible Filtering: Filter memos by creator, tags, visibility, and more
• Pagination: Efficiently handle large memo collections

Installation

npm install -g @hu14/memos-mcp

Or run directly with npx:

npx @hu14/memos-mcp

Configuration

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | MEMOS_API_URL | No | Your Memos instance URL (default: http://localhost:5230) | | MEMOS_API_TOKEN | Yes | Your Memos API access token |

Getting an API Token

1. Log in to your Memos instance
2. Go to Settings → Access Tokens
3. Create a new token with appropriate permissions

Claude Code Configuration

Add to your ~/.claude.json:

{
  "mcpServers": {
    "memos": {
      "command": "npx",
      "args": ["-y", "memos-mcp"],
      "env": {
        "MEMOS_API_URL": "https://your-memos-instance.com",
        "MEMOS_API_TOKEN": "your-api-token"
      }
    }
  }
}

Or for local development:

{
  "mcpServers": {
    "memos": {
      "command": "node",
      "args": ["/path/to/memos-mcp/dist/index.js"],
      "env": {
        "MEMOS_API_URL": "http://localhost:5230",
        "MEMOS_API_TOKEN": "your-api-token"
      }
    }
  }
}

Available Tools

Memos

• list_memos - List all memos with optional filtering and pagination

  • filter: Filter expression (e.g., creator == "users/1", tag == "ideas")
  • limit: Maximum number of memos to return (default: 10)
  • offset: Number of memos to skip for pagination
  • sort: Sort order (e.g., create_time desc, update_time)

• get_memo - Get a single memo by ID

  • name: Memo name/ID (e.g., memos/123)

• create_memo - Create a new memo

  • content: Memo content (supports Markdown)
  • visibility: Visibility level (PRIVATE, PROTECTED, PUBLIC)
  • tags: Array of tags to attach

• update_memo - Update an existing memo

  • name: Memo name/ID
  • content: New content
  • visibility: New visibility
  • tags: New tags (replaces existing)

• delete_memo - Delete a memo permanently

  • name: Memo name/ID to delete

Tags

• list_tags - List all tags

  • creator: Filter by creator
  • limit: Maximum number of tags

• create_tag - Create a new tag

  • name: Tag name (without # prefix)

  Returns: Tag name in success message

• delete_tag - Delete a tag

  • name: Tag name (e.g., tags/ideas)

Development

# Install dependencies
npm install

# Build
npm run build

# Run locally
MEMOS_API_URL=http://localhost:5230 MEMOS_API_TOKEN=xxx npm run dev

License

MIT