memos-mcp

> [中文文档](README_zh.md)

A Model Context Protocol (MCP) server for Memos — the open-source, self-hosted note-taking service. It communicates with Memos via the official HTTP REST API (v1) and exposes the MCP endpoint over HTTP (Streamable HTTP transport).

| Tool | Description | |------|-------------| | search_memos | Search memos by keyword or CEL filter expression | | get_memo | Retrieve the full content of a single memo | | create_memo | Create a new memo | | update_memo | Update content, visibility, or pinned state | | archive_memo | Archive a memo (hide from default view) | | delete_memo | Permanently delete a memo | | comment_memo | Add a comment to a memo |

• A running Memos instance (v0.22+)
• Go 1.21+ (only needed to build from source)

The server is configured via environment variables:

| Variable | Required | Description | |----------|----------|-------------| | MEMOS_SERVER_URL | Yes | Base URL of your Memos instance, e.g. http://localhost:5230 | | MEMOS_AUTH_TOKEN | No | API access token for authentication. Generate one in Memos → Settings → Access Tokens. If not set, the token can be supplied per-request via the MCP client (see Client-side token authentication). | | PORT | No | Port the MCP HTTP server listens on (default: 8080). |

docker run -d \
  -e MEMOS_SERVER_URL=http://your-memos-instance:5230 \
  -e MEMOS_AUTH_TOKEN=your_access_token_here \
  -p 8080:8080 \
  ghcr.io/wolfsilver/memos-mcp:latest

git clone https://github.com/wolfsilver/memos-mcp.git
cd memos-mcp
go build -o memos-mcp .

go install github.com/wolfsilver/memos-mcp@latest

Add t