Connect Memorion to Claude, Cursor & more

Set up the Memorion MCP server so your AI assistant can read your recordings, transcripts and summaries.

What you get

After setup you can ask your AI assistant things like "What did I talk about today?", "Summarize last week's meetings", or "Find the action items from my conversation with the design team". The connection is scoped to your own account: your assistant can read your recordings, transcripts, summaries and memories, and — only when you ask it to — add, edit, complete or remove a to-do. It can never modify or delete a recording.

Get your credentials

The easiest way is via the Memorion CLI, which handles login in the browser:

Terminal

npm install -g @memorion/cli
memorion login

Login saves your credentials to ~/.memorion/ — MCP picks them up from there automatically, so on the same machine you can even skip the env block below. Your user id is shown by `memorion whoami`.

Add Memorion to your MCP client

Add this to your client's MCP configuration. For Claude Desktop that file is claude_desktop_config.json (Settings → Developer → Edit Config); for Claude Code use claude mcp add; Cursor and others have an equivalent MCP settings screen.

claude_desktop_config.json

{
  "mcpServers": {
    "memorion": {
      "command": "npx",
      "args": ["-y", "@memorion/mcp"],
      "env": {
        "MEMORION_API_KEY": "memorion_dev_prod_xxx",
        "MEMORION_USER_ID": "<your_user_id>"
      }
    }
  }
}

Claude Code

claude mcp add memorion -e MEMORION_API_KEY=memorion_dev_prod_xxx -e MEMORION_USER_ID=<your_user_id> -- npx -y @memorion/mcp

Restart and test

Restart your MCP client. You should see "memorion" listed among connected servers. Then just ask:

"What did I record today?"

Available tools

The server exposes ten tools — nine read-only, plus update_todo, the only one that writes:

Tool	Description
get_current_user	Verify the connection; show account info
list_recordings	List or search recordings by keyword and time range
get_recording	Metadata, summary and audio availability for one recording
get_transcript	Full transcript with speaker labels
get_summary	AI summary: title, overview, action items
get_audio_url	Temporary download link for the raw audio (15 min)
search_memories	Keyword search over long-term memories
resolve_time_range	Resolve "last Wednesday" or "过去三天" into a real date range in your timezone
list_todos	List to-dos the AI extracted from your recordings
update_todo	Add, edit, complete or remove a to-do — the only tool that writes

Troubleshooting

• Server not showing up: check the JSON syntax of your config file, then fully restart the client.
• Tools return auth errors: verify MEMORION_API_KEY and MEMORION_USER_ID are set in the env block, or run memorion login on the same machine.
• npx download is slow on first run: the package is fetched once and cached afterwards.