mcp-memory

A hosted, multi-tenant MCP server for structured personal/business memory — notes across 13 purpose-built vaults, semantic search, typeahead, and real structured data tables (typed columns, filter, sort) — plus Scheduled Actions: freeform-text automations that run on a cadence, using your MCP Scraper tools to gather live data and mcp-memory to store it.

There is one backend: https://memory.mcpscraper.dev. This package is a thin local proxy to it — every tool call is forwarded over HTTPS with your API key; nothing runs or is stored on your machine.

Two ways to connect

OAuth remote connector (Claude.ai web, Claude Desktop's "Add custom connector") — no install, no key management. Add https://memory.mcpscraper.dev/mcp and log in.

This package, for clients that only support local stdio MCP servers (Claude Code, Cursor, Windsurf, and similar):

{
  "mcpServers": {
    "mcp-memory": {
      "command": "npx",
      "args": ["-y", "mcpscraper-memory"],
      "env": { "MCP_MEMORY_API_KEY": "mk_..." }
    }
  }
}

Get your key at memory.mcpscraper.dev, or from the mobile Scheduled Actions link (get-schedule-link).

Scheduled Actions access and billing

Scheduled Actions requires an active MCP Scraper Starter plan or higher. It is included with that plan rather than sold as a separate subscription, and there is no separate monthly run quota.

• Every started scheduled occurrence costs 75 MCP Scraper Credits.
• Agent-mode runs also add 1.5 times OpenRouter's actual reported model cost.
• Deterministic connection_sync runs do not use a model, so they cost only the 75-Credit base.
• Creating, listing, pausing, or deleting definitions does not itself consume a scheduled-run charge.

MCP Scraper is the source of truth for paid-plan access and the Credit ledger. mcp-memory retains the schedule definitions, default timezone, hosted-link key, and encrypted delegated MCP Scraper key; historical entitlement/quota columns are migration data, not current runtime gates. See the live Scheduled Actions guide and pricing.

Environment variables

• MCP_MEMORY_API_KEY (or MCP_MEMORY_KEY) — required. Alternatively, write the key to ~/.mcp-memory-key (or point MCP_MEMORY_KEY_PATH at a file containing it).
• MCP_MEMORY_BASE_URL — override the backend URL. Defaults to https://memory.mcpscraper.dev.

Run npx mcpscraper-memory --help for setup instructions from the terminal.