memo

listing.by

Keep persistent, searchable memory for coding agents, stored as Markdown and run entirely on your own machine.

state.local.long (state.local.title)listing.badge.runs_with

listing.install

listing.local.explain

uvx mlx-memo

listing.local.needs listing.local.note

act.add_to a11y.new_tabact.add_to a11y.new_tab

listing.share.h

listing.share.p_local

mcp.tc/i/memo

listing.about

memo gives MCP clients such as Claude Code, Codex, Cursor, Cline, Devin and OpenCode a persistent memory. Memories are plain Markdown files, indexed in SQLite with hybrid search that combines vector embeddings (MLX on Apple Silicon, sentence-transformers on CPU) and BM25. It also offers a time-machine for past states, contradiction scanning and a nightly maintenance run.

It runs locally over stdio from the mlx-memo PyPI package, with no cloud service and no API keys. The default MCP profile exposes 43 tools, with larger profiles available. It needs Python 3.13 or newer, and the first install downloads about 8 GB of models. macOS on Apple Silicon is fully supported; Linux and Docker use the CPU backend.

listing.can

  • Save decisions and notes as Markdown memories
  • Search memories by meaning with hybrid vector and BM25 retrieval
  • Query knowledge as it was on a past date
  • Scan for and resolve contradicting facts
  • Resume sessions across different agents
  • Sync memory between machines through your own git remote

listing.tools

listing.notools.local

listing.prompts

  • Save a memory that we use Postgres, not Mongo

  • Search my memory for what database we picked

  • What was our deploy strategy on 2026-02-01?

  • Scan my memories for contradicting decisions

listing.setup.h

listing.setup.local

Claude Code

  1. Run this in a terminal, in your project folder:
claude mcp add --transport stdio memo -- uvx mlx-memo
  1. Start Claude Code and type /mcp. memo should show as connected.

Add --scope user to make it available in every project.

Claude Desktop

  1. Open Settings → Developer → Edit Config. It opens claude_desktop_config.json. Add:
claude_desktop_config.json
{
  "mcpServers": {
    "memo": {
      "command": "uvx",
      "args": [
        "mlx-memo"
      ]
    }
  }
}
  1. Save the file and restart Claude Desktop.

Needs uv (Python) on your computer. The file lives in ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.

Cursor

Add to Cursor a11y.new_tab

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

mcp.json
{
  "mcpServers": {
    "memo": {
      "command": "uvx",
      "args": [
        "mlx-memo"
      ]
    }
  }
}

Needs uv (Python) on your computer.

VS Code

Install in VS Code a11y.new_tab

Or from a terminal:

code --add-mcp '{"name":"memo","type":"stdio","command":"uvx","args":["mlx-memo"]}'

Or commit it to the repo in .vscode/mcp.json:

.vscode/mcp.json
{
  "servers": {
    "memo": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mlx-memo"
      ]
    }
  }
}

Needs uv (Python) on your computer.

Devin Desktop

  1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "memo": {
      "command": "uvx",
      "args": [
        "mlx-memo"
      ]
    }
  }
}
  1. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf.

Codex

codex mcp add memo -- uvx mlx-memo

Or edit ~/.codex/config.toml directly:

config.toml
[mcp_servers.memo]
command = "uvx"
args = ["mlx-memo"]

Needs uv (Python) on your computer.

Gemini CLI

gemini mcp add memo uvx mlx-memo

This adds it to the current project. Add -s user to use it everywhere.

Any client

Most clients that start local servers accept this shape:

{
  "mcpServers": {
    "memo": {
      "command": "uvx",
      "args": [
        "mlx-memo"
      ]
    }
  }
}

Zed puts servers under context_servers in its settings, with the same command, args and env fields.

Needs uv (Python) on your computer.

listing.faq

Can I paste mcp.tc/i/memo into my MCP client?

No. memo runs on your own computer, started by your client, so it has no web address to connect to. The quick link is the page to share; the install command is uvx mlx-memo.

Does memo need an API key?

No. It doesn't declare any keys or environment variables. It runs with your user account's permissions, so check what its tools can reach.

Is memo a remote or a local server?

Local. Your client starts it as a process on your computer with uvx mlx-memo, which needs uv (Python).

What can memo do?

You can save decisions and notes as Markdown memories, search memories by meaning with hybrid vector and BM25 retrieval and query knowledge as it was on a past date.

Which clients can use it?

Any client that starts local servers: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed and others. claude.ai and ChatGPT only connect to remote servers.

Who wrote this page?

mcp.tc's robot read memo's public metadata (its package and repository pages), and an AI model drafted the text from it. A person reviews anything the checks can't confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.

listing.em.h

listing.em.lead_local listing.em.how

listing.em.badge

em.prev_lightem.prev_dark
Markdown
[![memo on mcp.tc](https://mcp.tc/i/memo/badge.svg)](https://mcp.tc/i/memo)
HTML
<a href="https://mcp.tc/i/memo"><img src="https://mcp.tc/i/memo/badge.svg" alt="memo on mcp.tc" height="20"></a>

listing.em.badge_note

listing.em.widget

HTML
<script src="https://mcp.tc/w/memo.js" async></script>

listing.em.widget_note

iframe

HTML
<iframe src="https://mcp.tc/embed/memo" title="memo on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

listing.em.iframe_note

JSON

listing.em.json_local

https://mcp.tc/i/memo.json

listing.em.fields

listing.related

listing.more_in

  • PMB AI

    oleksiijko

    state.local.label (state.local.title)

    Give AI coding agents persistent local memory for decisions, lessons and facts, stored in a single SQLite file on your disk.

    mcp.tc/i/pmb-ai

  • screenpipe

    AI & Machine Learning

    state.local.label (state.local.title)

    Search your local screen recordings, audio transcripts and computer activity captured by screenpipe.

    mcp.tc/i/screenpipe

  • MCP Memory Service

    doobidoo

    state.local.label (state.local.title)

    Store and search persistent semantic memory with a knowledge graph, shared across agents, sessions and AI clients.

    mcp.tc/i/mcp-memory-service

  • MiniMax

    AI & Machine Learning

    state.local.label (state.local.title)

    Generate speech, clone voices, and create images and videos with MiniMax models from your AI assistant.

    mcp.tc/i/minimax

  • Sequential Thinkingvf.sr

    MCP reference servers

    state.local.label (state.local.title)

    Work through problems as a sequence of thoughts that can be revised, branched and extended as understanding grows.

    mcp.tc/i/sequential-thinking

  • Memoryvf.sr

    MCP reference servers

    state.local.label (state.local.title)

    Store and recall persistent memory across sessions using a local knowledge graph.

    mcp.tc/i/memory

listing.disclaimer_checked