Gemini

Add the GearDex MCP adapter to the Gemini app or Gemini CLI.

StudioThe Studio API, webhooks, and MCP adapter are included with the Studio plan.Compare plans

Gemini app

The Gemini app for macOS and Windows runs the adapter as a local MCP server. Gemini has no field for environment variables, so the adapter reads your key from a file in your home folder. Gemini does not get the key.

Create a Studio API key in Settings, API & Agents. For a first test, give the key read scopes only.
Copy the key.
Install Node 22 or newer.
Open Terminal (macOS) or PowerShell (Windows).
Run the Save the key command for your system. The command writes the key from your clipboard to ~/.local/share/geardex/studio-api-key. The default Gemini sandbox can read this file.
In Gemini, open More, Connectors.
Click + Custom.
Click Local MCP.
In Server Name, type GearDex.
Type a description, for example Gear, shoots and studio records.
In Command, paste the command for your system.
Keep Sandbox settings at Default. The default sandbox gives access to the npm cache and ~/.local. The adapter needs no other access.
Click Next. Gemini starts the adapter and shows its 69 tools.
Click Connect.
Read the permissions.
Select the check box.
Click Allow.
Start a new chat.
Send a starter prompt.

macOS

bashSave the key (Terminal)

mkdir -p ~/.local/share/geardex && pbpaste > ~/.local/share/geardex/studio-api-key && chmod 600 ~/.local/share/geardex/studio-api-key

bashCommand

npx --yes --package https://github.com/dylandersen/geardex-public/releases/download/mcp-v0.2.0/geardex-mcp-0.2.0.tgz geardex-mcp --key-file ~/.local/share/geardex/studio-api-key

Windows

textSave the key (PowerShell)

New-Item -ItemType Directory -Force "$HOME\.local\share\geardex" | Out-Null; (Get-Clipboard).Trim() | Set-Content -NoNewline "$HOME\.local\share\geardex\studio-api-key"

textCommand

npx.cmd --yes --package https://github.com/dylandersen/geardex-public/releases/download/mcp-v0.2.0/geardex-mcp-0.2.0.tgz geardex-mcp --key-file ~/.local/share/geardex/studio-api-key

Gemini CLI

Create a Studio API key in Settings, API & Agents. For a first test, give the key read scopes only.
Install Node 22 or newer.
Open ~/.gemini/settings.json in a text editor. If the file does not exist, create it.
Caution: If the file already has settings or an mcpServers block, do not replace them. Add the geardex entry in the mcpServers block.
Paste the config below into the file.
Replace gdx_live_REPLACE_ME with your key.
On Windows, change npx to npx.cmd.
Save the file.
Start gemini.
Run /mcp.
Make sure that geardex shows as connected.
Send a starter prompt.

json~/.gemini/settings.json

{
  "mcpServers": {
    "geardex": {
      "command": "npx",
      "args": [
        "--yes",
        "--package",
        "https://github.com/dylandersen/geardex-public/releases/download/mcp-v0.2.0/geardex-mcp-0.2.0.tgz",
        "geardex-mcp"
      ],
      "env": {
        "GEARDEX_STUDIO_API_KEY": "gdx_live_REPLACE_ME"
      }
    }
  }
}