Skip to main content
gork-mcp is a Model Context Protocol server that plugs your Gork workspace directly into Claude, Cursor, Windsurf, Codex, Copilot, and any other MCP client. It runs over stdio, authenticates with a Bearer API key, and exposes 13 email tools — no REST wrangling required.

​
Prerequisites

Gork account + API key

Generate a key in the Console. Keys start with gork_live_ and scope every tool call to your organization.

Verified domain (custom sending)

Sandbox inboxes send immediately. To send from your own domain, verify it first.

​
Install

One command — the binary ships inside @gork/sdk:
Configuration via flags or environment variables: Pick a client to connect it:

Claude (Desktop + Code)

claude_desktop_config.json or claude mcp add.

Cursor

Project .cursor/mcp.json or global config.

Windsurf

mcp_config.json server block.

Codex CLI

config.toml [mcp_servers.gork].

VS Code + GitHub Copilot

.vscode/mcp.json with MCP support enabled.

​
Tools

​
Inboxes

​
Reading

​
Sending

​
Drafts

​
Files

Tool output is truncated at 6000 characters so responses stay readable. Attachments larger than 2MB are refused inline — the tool returns a pointer to fetch them directly with GET /v1/attachments/:id.

​
Example conversations

Once connected, talk to your agent naturally: Summarize new mail
“Summarize the new mail in inbox inb_abc123.” → calls gork_read_emails with { "inboxId": "inb_abc123", "limit": 20 }
Reply in thread
“Find the thread about the Q3 invoice and reply that payment went out today.” → calls gork_search_emails with { "query": "Q3 invoice" }, then gork_get_thread, then gork_reply_email with the original messageId.
Draft, then send after review
“Draft a follow-up to prospect@example.com about Thursday’s sync — don’t send it yet.” → calls gork_create_draft. After you approve: gork_send_draft.

​
Safety

gork_send_email and gork_reply_email execute immediately — there are no confirmation gates. The agent sends the moment it calls the tool.
  • Scope keys per agent. Create a dedicated API key for each agent so a compromised or misbehaving agent can only touch its own inboxes.
  • Use drafts for human-in-the-loop. Have the agent compose with gork_create_draft; a human reviews and sends with gork_send_draft.

​
Next steps

Claude setup

Connect Claude Desktop or Claude Code.

API reference

The REST endpoints behind every tool.

AI SDKs

TypeScript, Python, LangChain, and Vercel AI adapters.

Webhooks

Get push notifications for inbound mail instead of polling.