Back to GigaRAG

Connect an agent

Give an AI tool access to your GigaRAG Workspace, so it can search, read and write your memos while it works.

Claude Code Desktop

Claude Code in the desktop app. It reads the same MCP config as the terminal version, plus your Claude connectors.

Connect with the GigaRAG CLI

Claude Code Desktop reads the same settings file as another tool, so the CLI sets both up at once. Signing in happens in your browser, so no key is written into any config file.

npm install -g gigarag
gigarag login
gigarag connect claude-code

Paste what it prints, then restart Claude Code Desktop afterwards. Nothing here expires, and gigarag connect --remove takes GigaRAG back out of everything it touched.

Sign in with GigaRAG

Connect without a key: Claude Code Desktop opens your browser, you sign in to GigaRAG and pick this workspace.

  1. 1.

    Add GigaRAG as a connector on your Claude account

    Follow the permanent connector steps in the Claude guide. Connectors on your account show up in Claude Code Desktop.

  2. 2.

    Click + next to the prompt box, then Connectors, and turn on GigaRAG

Or set it up by hand

  1. 1.

    Open ~/.claude.json and add GigaRAG under mcpServers

    The file already exists and holds other settings, so add to the top-level mcpServers object rather than replacing anything.

    ~/.claude.json
    "mcpServers": {
  "gigarag": {
    "type": "http",
    "url": "https://mcp.gigarag.com/mcp",
    "headers": { "Authorization": "Bearer <api-key>" }
  }
}
  2. 2.

    Quit and reopen the app

    Or, if the Claude Code terminal version is installed, follow the Claude Code guide instead. Both read the same file.

Check it worked

Send this once it is connected. An answer drawn from your workspace means the connection is live.

List my GigaRAG buckets.

Written from the official docs: Claude Code MCP, Desktop