> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gork.email/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude

> Connect the gork-mcp server to Claude Desktop and Claude Code.

<Steps>
  <Step title="Get an API key">
    Generate a key in the [Console](https://gork.email/dashboard). Keys start with `gork_live_`.
  </Step>

  <Step title="Connect your client">
    Follow **Option A** (Desktop app) or **Option B** (Code CLI) below.
  </Step>

  <Step title="Verify">
    Ask Claude: *"List my inboxes."* It should call `gork_list_inboxes` and show your addresses.
  </Step>
</Steps>

## Option A — Claude Desktop

Add the `gork` server block to your config file:

* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json theme={null}
{
  "mcpServers": {
    "gork": {
      "command": "npx",
      "args": ["-y", "-p", "@gork/sdk", "gork-mcp", "--api-key=gork_live_YOUR_KEY"]
    }
  }
}
```

Restart Claude Desktop so it picks up the new server.

## Option B — Claude Code CLI

Register the server from your terminal:

```bash theme={null}
claude mcp add gork -- npx -y -p @gork/sdk gork-mcp --api-key=gork_live_YOUR_KEY
```

Confirm it is registered:

```bash theme={null}
claude mcp list
```

You should see `gork` in the server list with its 13 tools available.

<Note>
  Prefer not to put the key on the command line? Export `GORK_API_KEY` (or `GORK_KEY`) in your shell and drop the `--api-key` flag — `gork-mcp` reads it from the environment. Override the API base with `GORK_BASE_URL` if needed.
</Note>