Skip to main content
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

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

ModelFree Tier RPMNotes
gemini-2.5-flash-lite10 (4,000 with billing)Default. Fastest, highest free RPM
gemini-2.5-flash5 (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

Build docs developers (and LLMs) love