Skip to content

Connect Claude Code, Codex, Cursor or Gemini CLI

Add Wahlu to your coding agent with one command, or with a Wahlu API key for Cursor and Gemini CLI.

Updated

Claude Code

  1. Run this in your project:

    claude mcp add --transport http wahlu https://mcp.wahlu.com/mcp
    
  2. In Claude Code, type /mcp, pick wahlu and sign in to Wahlu.

To use Wahlu in every project, add --scope user before wahlu. See the Claude Code guide.

Codex

  1. Run these two commands:

    codex mcp add wahlu --url https://mcp.wahlu.com/mcp
    codex mcp login wahlu
    
  2. Sign in to Wahlu in the browser that opens.

  3. Start a new Codex session.

See the Codex guide.

Cursor and Gemini CLI

These use a Wahlu API key and run Wahlu on your computer. You need Node.js.

  1. In Wahlu, make an API key. Go to Workspace settings, then API keys, then Create key. Give it only the brands and permissions it needs.
  2. Add Wahlu to your agent's settings file. For Cursor, that's ~/.cursor/mcp.json. For Gemini CLI, it's ~/.gemini/settings.json.
  3. Paste your key where it says. For Gemini CLI, put the key in your shell as WAHLU_API_KEY instead.

The Cursor guide and Gemini CLI guide have the exact settings to copy.

Questions

Why do Cursor and Gemini CLI need an API key?
They can't sign in to the hosted Wahlu server the way Wahlu needs. So they run a small Wahlu server on your computer that uses an API key.

Still stuck?

We are happy to help. In Wahlu, click the ? button, then Contact support. Or email hello@wahlu.com.