Cursor + Gemini Setup

Use Claude Mem in Cursor with Google’s free Gemini API

Free Tier: 1,500 requests per day with gemini-2.5-flash-lite. No credit card required.

Step 1: Get a Gemini API Key

1. Go to Google AI Studio
2. Sign in with your Google account and accept the Terms of Service
3. Click Create API key, choose or create a Google Cloud project
4. Copy your API key — you’ll need it in Step 3

Enable billing on your Google Cloud project to unlock 4,000 RPM (vs 10 RPM without billing). You won’t be charged unless you exceed the free quota.

Step 2: Clone and build Claude Mem

git clone https://github.com/thedotmack/claude-mem.git
cd claude-mem
bun install
bun run build

Step 3: Configure Gemini provider

Interactive setup (recommended)

Run the setup wizard — it detects you don’t have Claude Code, lets you pick Gemini, and installs hooks automatically:

bun run cursor:setup

Manual configuration

mkdir -p ~/.claude-mem
cat > ~/.claude-mem/settings.json << 'EOF'
{
  "CLAUDE_MEM_PROVIDER": "gemini",
  "CLAUDE_MEM_GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"
}
EOF

bun run cursor:install
bun run worker:start

Step 4: Restart Cursor and verify

Restart Cursor IDE, then confirm everything is running:

bun run worker:status
bun run cursor:status

Open http://localhost:37777 to see the memory viewer.

Available models

Model	Free Tier RPM	Notes
gemini-2.5-flash-lite	10 (4,000 with billing)	Default. Fastest, highest free RPM
gemini-2.5-flash	5 (1,000 with billing)	Higher capability

To change the model, update ~/.claude-mem/settings.json:

{
  "CLAUDE_MEM_PROVIDER": "gemini",
  "CLAUDE_MEM_GEMINI_API_KEY": "your-key",
  "CLAUDE_MEM_GEMINI_MODEL": "gemini-2.5-flash"
}

Next steps

Cursor Integration Overview

All Cursor features and hook mappings

OpenRouter Setup

Alternative provider with 100+ models