mcp-memory

@vilovieta/mcp-memory is a stdio MCP server that bridges any MCP client to the hosted mcp-memory service at https://memory.mcpscraper.dev — a multi-tenant, access-controlled, per-user memory product (Obsidian/Neon-backed) exposed as an MCP server.

It is a thin proxy: on startup it reads your API key, lists the tools the hosted service exposes, and forwards every tools/call to the hosted execute routes with your key injected. You always get the live tool set — nothing is hardcoded in this package.

What you get

All 23 hosted memory tools, including:

• Notes: listTool, getTool, putTool, searchTool, exportTool, uploadTool, deleteNoteTool
• Facts: recordFactTool, factHistoryTool
• Knowledge: libraryIngestTool, memoryQuestionsTool, temporalRecallTool
• Vaults: listVaultsTool, addVaultTool, deleteVaultTool
• Access control: issueKeyTool, listKeysTool, revokeKeyTool, setScopeTool, shareVaultTool, swapVaultTool
• Metering: storageUsageTool, costUsageTool

Install

Run it from any MCP client that can launch a stdio command. Set your key first:

export MCP_MEMORY_KEY="mk_your_key"
npx -y -p @vilovieta/mcp-memory@latest mcp-memory

In a human terminal the command prints a short info card; when launched by an MCP client over stdio it speaks protocol-clean JSON-RPC.

Configuration

| Env var | Required | Description | | --- | --- | --- | | MCP_MEMORY_KEY | yes | Your mcp-memory API key (Bearer secret, mk_...). Also accepted as MCP_MEMORY_API_KEY. | | MCP_MEMORY_BASE_URL | no | Override the hosted endpoint. Defaults to https://memory.mcpscraper.dev. | | MCP_MEMORY_KEY_PATH | no | Read the key from a file. Defaults to ~/.mcp-memory-key. |

The key is injected into every tool call for you, so the apiKey argument is hidden from the advertised tool schemas.

Client config

Claude Code

claude mcp add mcp-memory --env MCP_MEMORY_KEY=mk_your_key -- npx -y -p @vilovieta/mcp-memory@latest mcp-memory

Claude Desktop / Codex / any MCP client

{
  "mcpServers": {
    "mcp-memory": {
      "command": "npx",
      "args": ["-y", "-p", "@vilovieta/mcp-memory@latest", "mcp-memory"],
      "env": {
        "MCP_MEMORY_KEY": "mk_your_key"
      }
    }
  }
}

License

MIT