Skip to main content

Standalone MCP server for the Mnemo platform — connects Mnemo memory to Claude Desktop, Claude Code, and any MCP client.

Project description

mnemo-meridian-mcp

Standalone MCP server for the Mnemo platform. Connects Mnemo's memory and intelligence layer to Claude Desktop, Claude Code, and any MCP-compatible client.

Install

pip install mnemo-meridian-mcp

Setup

1. Get your token

Open Mnemo → Settings → "Connect to Claude Desktop & Claude Code" → Generate Token.

2. Add to Claude Desktop config

Edit ~/claude_desktop_config.json (or ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "mnemo": {
      "command": "mnemo-mcp",
      "env": {
        "MNEMO_API_URL": "https://api.mnemomcp.com",
        "MNEMO_API_TOKEN": "your-token-here"
      }
    }
  }
}

Restart Claude Desktop. The Mnemo tools will appear in any Claude conversation.

3. For Claude Code

Add the same block to .mcp.json in your project root.

Tools

Tool What it does
search_memory Semantic search over your session history
get_open_threads Unresolved threads sorted by recurrence
get_decisions Strategic decisions with confidence + rationale
get_entities People, companies, projects, topics you've mentioned
get_morning_brief Structured brief of what matters right now
log_session Index an external session into Mnemo memory
log_decision Record a decision from any context

Environment variables

Variable Required Default Description
MNEMO_API_URL Yes http://localhost:7432 URL of the Mnemo platform API
MNEMO_API_TOKEN Yes (reads ~/.mnemo/mcp_token) Long-lived platform token
MNEMO_API_TOKEN_CMD No Command that prints a bearer token (used if token/file are empty)
MNEMO_OAUTH_ACCESS_TOKEN No Optional externally-brokered access token fallback
MNEMO_PROFILE No auto-resolved via /me Optional explicit profile slug override
MAX_MCP_OUTPUT_CHARS No 20000 Max characters returned per tool call before truncation
MNEMO_ALLOW_INSECURE_HTTP No 0 Set 1 to allow non-loopback HTTP (testing only)

Security defaults

  • Non-loopback http:// API URLs are blocked by default.
  • Use https://... for remote Mnemo backends.
  • For controlled local/LAN testing only, set MNEMO_ALLOW_INSECURE_HTTP=1.

How it works

mnemo-mcp is a thin HTTP client over the Mnemo REST API. It has no dependency on the Mnemo backend codebase — it only requires the mcp package and Python stdlib. The token is issued at the platform level (not tied to any specific Mnemo app).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mnemo_meridian_mcp-0.2.1.tar.gz (133.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mnemo_meridian_mcp-0.2.1-py3-none-any.whl (115.2 kB view details)

Uploaded Python 3

File details

Details for the file mnemo_meridian_mcp-0.2.1.tar.gz.

File metadata

  • Download URL: mnemo_meridian_mcp-0.2.1.tar.gz
  • Upload date:
  • Size: 133.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for mnemo_meridian_mcp-0.2.1.tar.gz
Algorithm Hash digest
SHA256 8c01ea29b3fc77bc6c2118c98a5f7156cfb4d7b0727d3051ba2807e646e88bd8
MD5 4a2a1ac0871373a846377a482de3568c
BLAKE2b-256 44d508f3385a7d48742379237b8febb881815ddab9faea600e3105fd81377352

See more details on using hashes here.

File details

Details for the file mnemo_meridian_mcp-0.2.1-py3-none-any.whl.

File metadata

File hashes

Hashes for mnemo_meridian_mcp-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 45d53e1be5034f74de42fda56984d5ee4b35008c6448da98cebb2713b61bb8b8
MD5 f7870a680fde42b5fafb22a5d4be823b
BLAKE2b-256 3b3b0fc63e2eabe7bf2bcd610a85fd08ef6f6a1a8fb3f830fbf0bd4edbb1d937

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page