Memos

MCP Server for the self-hosted notes app Memos

python

4

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "red5d-memos_mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "/path/to/memos_mcp",
        "memos-mcp"
      ],
      "env": {
        "MEMOS_BASE_URL": "http://localhost:5230",
        "MEMOS_API_TOKEN": "your-token-here"
      }
    }
  }
}

You can run the Memos MCP Server to enable AI assistants to search, create, update, and retrieve memos from a Memos instance. This server exposes convenient tools that let you work with memos through a standardized MCP interface, making it easier to integrate memo data into your workflows and assistants.

How to use

To interact with memos from an MCP client, start the server you configured (see the installation section). Once running, you can use the provided tools to search memos by content, creator, tags, and visibility, create new memos with Markdown content, update existing memos, and fetch a memo by UID. Use these actions to build assistants that manage knowledge and notes from your Memos instance.

How to install

Prerequisites: Python installed for server code, or you can run the server via common MCP runtimes like uv, uvx, or Python modules. You may also use a containerized approach if you prefer.

# Running with uvx (no installation required)
uvx --from /path/to/memos_mcp memos-mcp

# Running with uv after installation
uv run memos-mcp

# Running with FastMCP directly
fastmcp run server.py

# Programmatic usage (example)
from server import mcp
# The server is ready to use

Configuration and runtime environment

Configure the client and server with the required environment variables to point to your Memos instance and provide authentication if needed.

export MEMOS_BASE_URL="http://localhost:5230"
export MEMOS_API_TOKEN="your-token-here"

Available tools

search_memos

Search memos with optional filters such as query text, creator, tag, visibility, and pagination.

create_memo

Create a new memo with content that supports Markdown and set the initial visibility.

update_memo

Update an existing memo's content, visibility, or pinned status using its UID.

get_memo

Retrieve a specific memo by its UID.