[!NOTE] This repository is archived. As of v0.27.0, Memos now includes a native MCP server implementation, making this standalone server unnecessary.

Memos MCP Server

Python Application GitHub License pre-commit Ruff

An MCP server for interacting with Memos.

Tools

This MCP server provides the following tools:

create_memo

Create a memo and return the name of the memo.

Parameters

• content (string): The content of the memo in Markdown format.
• visibility (string, optional): The visibility of the memo (private, protected, public).

attach_file

Attach a file to a memo.

Parameters

• memo_name (string): The name of the memo.
• filename (string): The name of the file.
• content (string): Base64 representation of a file or a URL to a file to attach to the memo.
• mime_type (string, optional): The MIME type of the file.

Installation

[!NOTE] You'll need uv installed on your system to use uvx command.

For Claude Desktop

Download the latest MCP bundle mcp-memos.mcpb from the Releases page, then open the downloaded .mcpb file or drag it into the Claude Desktop's Settings window.

You can also manually configure this server for Claude Desktop. Edit the claude_desktop_config.json file by adding the following entry under mcpServers:

{
  "mcpServers": {
    "bear": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-memos",
        "mcp-memos",
        "--endpoint",
        "<Memos server address>",
        "--token",
        "<Your token>"
      ]
    }
  }
}

After editing, restart the application. For more information, see: For Claude Desktop Users - Model Context Protocol.

For Goose CLI

To enable the Bear extension in Goose CLI, edit the configuration file ~/.config/goose/config.yaml to include the following entry:

extensions:
  bear:
    name: Memos
    cmd: uvx
    args: [--from, git+https://github.com/jkawamoto/mcp-memos, mcp-memos]
    envs: {
      "MEMOS_API_ENDPOINT": "<Memos server address>",
      "MEMOS_API_TOKEN": "<Your token>"
    }
    enabled: true
    type: stdio

For Goose Desktop

Add a new extension with the following settings:

• Type: Standard IO
• ID: memos
• Name: Memos MCP Server
• Description: An MCP server for interacting with Memos
• Command: uvx --from git+https://github.com/jkawamoto/mcp-memos mcp-memos
• Environment Variables: Add MEMOS_API_ENDPOINT with Memos server address and MEMOS_API_TOKEN with your api token

For more details on configuring MCP servers in Goose Desktop, refer to the documentation: Using Extensions - MCP Servers.

License

This application is licensed under the MIT License. See the LICENSE file for more details.