Memos πŸ“ MCP Server

A Python package enabling LLM models to interact with the Memos server via the MCP interface for searching, creating, retrieving, and managing memos.

Remote serverstreamable-httpPython

What is the Memos πŸ“ MCP server?

Memos πŸ“ MCP server exists for a simple reason β€” assistants are far more useful when they can act on Memos πŸ“ directly instead of describing what you should do. A Python package enabling LLM models to interact with the Memos server via the MCP interface for searching, creating, retrieving, and managing memos.

What you get

You can include this package in your config file as bellow, just as you use other Python MCP plugins.

What the assistant can call

Once Memos πŸ“ is connected, these are the calls the assistant has available:

  • visibility β€” Tag visibility (PUBLIC/PROTECTED/PRIVATE, default: PRIVATE) |
  • list_memo_tags β€” List all existing memo tags
  • search_memo β€” Search for memos using keywords
  • create_memo β€” Create a new memo
  • get_memo β€” Get a specific memo by ID

Configuration and credentials

You will need one environment variable: YOUR_ACCESS_TOKEN. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Setting it up

Being a remote server, there is no local install. You register the endpoint with your client, authorise it once, and the tools appear.

Choosing this one

Plenty of AI and media services servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Memos πŸ“'s toolset β€” visibility, list_memo_tags, search_memo and 2 more β€” is a fair guide to whether it matches your workflow. It is maintained by RyoJerryYu; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live β€” if something here drifts out of date, it is a bug worth reporting.

Before you rely on it

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • Missing credentials fail quietly in some clients β€” if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the memos πŸ“ mcp server does with a few real requests.

Available tools

ToolWhat it does
visibilityTag visibility (PUBLIC/PROTECTED/PRIVATE, default: PRIVATE) |
list_memo_tagsList all existing memo tags
search_memoSearch for memos using keywords
create_memoCreate a new memo
get_memoGet a specific memo by ID

How to install the Memos πŸ“ MCP server

{
  ...,
  "mcpServers": {
    "fetch": { // other mcp servers
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    },
    "memos": { // add this to your config
      "command": "uvx",
      "args": [
        "--prerelease=allow",
        "mcp-server-memos",
        "--host",
        "localhost",
        "--port",
        "5230",
        "--token",
        "your-access-token-here"
      ]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
YOUR_ACCESS_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • β€œUse Memos πŸ“ to visibility.”
  • β€œUse Memos πŸ“ to list memo tags.”
  • β€œUse Memos πŸ“ to search memo.”

Frequently asked questions

Memos is a lightweight, self‑hosted memo hub. It allows you to store short notes and snippets on your own server.