home / mcp / memos mcp server

Memos MCP Server

Provides MCP endpoints to create memos and attach files for interaction with Memos, via stdin/stdout integrations.

Installation

Add the following to your MCP client configuration file.

Configuration

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

This MCP server enables you to interact with Memos by creating memos and attaching files through a simple MCP interface. It supports practical integrations with desktop and CLI environments, letting you leverage memo management from your preferred tools.

How to use

You interact with this MCP server through an MCP client or integration that speaks the MCP protocol. You can perform the following actions:

Create a memo with Markdown content and receive the memo name as the response.
Attach a file to an existing memo by providing the memo name, the file name, and the file data as a base64 string or a URL to load.

How to install

Prerequisites and setup steps depend on how you want to run the server. If you intend to use the provided UDP/CLI-based integrations, you should ensure you have the required runtime helper installed.

Install the helper that enables running MCP servers from command line or desktop integrations. Install the uv helper as noted in the provided configuration examples.

# Claude Desktop integration (example)
# After downloading the MCP bundle, use the in-app import or place the JSON configuration under the MCP servers section.

Additional information

Two concrete integration examples are shown for running the server from a desktop CLI and from a Goose CLI workflow. The examples assume you have the uvx runtime installed and that you configure the endpoint and token as shown in the code blocks.

Available tools

create_memo

Create a memo with Markdown content and return the memo name.

attach_file

Attach a file to a memo by providing the memo name, file name, and the file data or URL.