Cursor + OpenRouter Setup

Use Claude-Mem in Cursor with your OpenRouter key

Cursor + OpenRouter Setup

Use your OpenRouter key so memory notes run off-plan on your OpenRouter credit. You do not clone the repo.

Never send a personal sk-or- key to https://cmem.ai/api/inference. For your own OpenRouter account, leave the base URL empty (or https://openrouter.ai/api/v1). CMEM Pro uses the cmem.ai inference URL with a CMEM Pro key, not your OpenRouter key.

Install

1. Create a key at OpenRouter API Keys.
2. Run:

npx claude-mem install

Pick Cursor, then pick your OpenRouter key as the memory provider.

npm install -g claude-mem is the library only. Always install with npx claude-mem install.

Settings by hand (optional)

mkdir -p ~/.claude-mem
cat > ~/.claude-mem/settings.json << 'EOF'
{
  "CLAUDE_MEM_PROVIDER": "openrouter",
  "CLAUDE_MEM_OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY"
}
EOF

Leave CLAUDE_MEM_OPENROUTER_BASE_URL unset for OpenRouter itself. Then re-run npx claude-mem install so Cursor hooks and the worker are in place. Do not restart a healthy worker.

Restart Cursor

Close and reopen Cursor so hooks load.

Verify

Health: curl -s "http://127.0.0.1:${CLAUDE_MEM_WORKER_PORT}/api/health". Open the worker URL from install to see notes.

Models

Set CLAUDE_MEM_OPENROUTER_MODEL if you do not want the default. Free model ids on OpenRouter often end in :free — check the model list.

{
  "CLAUDE_MEM_PROVIDER": "openrouter",
  "CLAUDE_MEM_OPENROUTER_API_KEY": "your-key",
  "CLAUDE_MEM_OPENROUTER_MODEL": "google/gemini-2.0-flash-exp:free"
}

Other OpenAI-shaped servers

The OpenRouter provider is a generic OpenAI-compatible client. Set CLAUDE_MEM_OPENROUTER_BASE_URL to DeepSeek, LM Studio, or any gateway that speaks /chat/completions. The model id is sent as-is.

DeepSeek

{
  "CLAUDE_MEM_PROVIDER": "openrouter",
  "CLAUDE_MEM_OPENROUTER_BASE_URL": "https://api.deepseek.com",
  "CLAUDE_MEM_OPENROUTER_MODEL": "deepseek-chat",
  "CLAUDE_MEM_OPENROUTER_API_KEY": "YOUR_DEEPSEEK_API_KEY"
}

LM Studio (local)

{
  "CLAUDE_MEM_PROVIDER": "openrouter",
  "CLAUDE_MEM_OPENROUTER_BASE_URL": "http://localhost:1234/v1",
  "CLAUDE_MEM_OPENROUTER_MODEL": "your-local-model-id"
}

Troubleshooting

Key not configured — cat ~/.claude-mem/settings.json should show provider openrouter and your key.

Model not found — check the id at OpenRouter Models.

Worker idle — read ~/.claude-mem/logs/worker-YYYY-MM-DD.log. Do not restart a healthy worker.

Next steps

• Cursor Integration — default CMEM Pro install
• Gemini
• Configuration