MCP Setup Guide

Connect Claude Desktop to your MNEMOS vault and give your AI full recall of your sovereign memory.

Prerequisites

→Claude Desktop installed
→MNEMOS account with at least one memory in your vault
→Your MNEMOS API key — generated in the API Gateway tab of your vault

Step-by-step setup

Generate your API key

1.Open your vault at mnemosbase.com/vault
2.Navigate to the API Gateway module (last tab in the sidebar)
3.Click Generate API Key and sign with your wallet
4.Copy the raw key — it is shown once and never stored in plaintext

WARNING

MNEMOS stores only the SHA-256 hash of your key. If you lose it, generate a new one — the old key is permanently gone and cannot be recovered.

Configure Claude Desktop

Locate your Claude Desktop config file:

macOS

bash

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

bash

%APPDATA%\Claude\claude_desktop_config.json

Add the MNEMOS MCP server block:

json

{
  "mcpServers": {
    "mnemos": {
      "command": "npx",
      "args": ["-y", "@mnemos-ai/mcp-server"],
      "env": {
        "MNEMOS_API_KEY": "your_api_key_here"
      }
    }
  }
}

TIP

Replace your_api_key_here with the key copied in Step 1. The npx -y flag automatically installs the latest MCP server package on first run.

Restart Claude Desktop

Fully quit and reopen Claude Desktop. After restarting you should see MNEMOS listed under connected tools in the Claude interface (hammer icon).

Sync wallet-encrypted memories (AI Vault Bridge)

API-ingested memories (api source) are available to Claude immediately. For wallet-encrypted memories (goals, decisions, health, relationships, context), you need to bridge them through the AI Vault Bridge:

1.Open your vault and navigate to API Gateway
2.Find the AI Vault Bridge section
3.Click Sync unlocked memories
4.Sign with your wallet — one signature, no gas
5.Claude can now recall those memories for 60 minutes

NOTE

Click Revoke at any time to immediately clear the session and remove Claude's access to your encrypted memories. Sessions also auto-expire after 60 minutes.

Available MCP tools

Tool	Description
recall	Search your vault by query, category, or tag
remember	Write a new memory to your vault (api source)
update_memory	Update an existing memory by ID
forget	Soft-delete a memory by ID
list_tags	Return all tags used across your vault
list_categories	Return all memory categories

Remote MCP (Claude.ai / Claude Code)

If you are using Claude.ai or Claude Code on the web instead of Claude Desktop, connect via the remote HTTP endpoint — no local process needed:

text

https://mnemosbase.com/api/mcp

When prompted for authentication, enter your MNEMOS API key as a Bearer token: mnemos_live_your_key_here

NOTE

The remote endpoint uses the Streamable HTTP MCP transport (stateless). All six tools — recall, remember, update_memory, forget, list_tags, list_categories — work identically to the local server.

Troubleshooting

MNEMOS not showing in Claude Desktop

Verify the config file is valid JSON — a trailing comma or missing bracket silently fails. Use a JSON validator, then restart Claude Desktop completely (not just close the window).

recall returns no results

Check your API key is correct. For wallet-encrypted memories, complete the AI Vault Bridge sync first — Claude cannot access those memories without an active session.

Session expired after 60 minutes

Return to API Gateway → AI Vault Bridge and click Sync unlocked memories to start a fresh session.