MCP Server Memos

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

python

20

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": {
    "ryojerryyu-mcp-server-memos-py": {
      "command": "uvx",
      "args": [
        "--prerelease=allow",
        "mcp-server-memos",
        "--host",
        "localhost",
        "--port",
        "5230",
        "--token",
        "YOUR_ACCESS_TOKEN"
      ]
    }
  }
}

You run a local Memos server that communicates via the MCP (Model Context Protocol) to let your LLM access, search, and manage memo content. This server focuses on memos with features like keyword search, memo creation with visibility controls, content retrieval by ID, tag management, and secure access through tokens. It’s designed to be used by MCP clients, enabling you to integrate memo data into your models and workflows with a consistent protocol.

How to use

Start the memos MCP server and connect it to your MCP client. You can run it locally and point your client to host localhost on the configured port. Use the token that your client and server share to authenticate requests. From your MCP client, you will be able to search memos by keywords, create new memos with visibility settings, retrieve memo contents by ID, and manage memo tags. The server exposes a stable, single point of contact for memo data that your models can access through standard MCP calls.

How to install

pip install mcp-server-memos

Run the server via CLI (example)

mcp-server-memos --host localhost --port 8080 --token YOUR_ACCESS_TOKEN

Or, as a library usage example

from mcp_server_memos import Config, serve_stdio

config = Config( host="localhost", port=8080, token="YOUR_ACCESS_TOKEN" )

await serve_stdio(config=config)

## Configuration and usage notes

Configure the MCP connection in your client’s MCP setup by adding a stdio server entry that points to the memos MCP server command. The example below shows how to wire the memos server into your MCP clients alongside other servers. You pass the host, port, and token as shown to enable authenticated access to memos.

## Available tools

### list\_memo\_tags

List all existing memo tags with options to specify the parent and visibility.

### search\_memo

Search memos by keyword content to retrieve matching memo IDs or summaries.

### create\_memo

Create a new memo with content and visibility settings (PUBLIC/PROTECTED/PRIVATE).

### get\_memo

Retrieve the content of a memo by its ID or name.