What is Gork mail (also searched as Grokmail or gork.email)?

Gork mail (gork.email, often spelled Grokmail or Grok mail) is programmable email infrastructure designed specifically for AI agents, LLMs, and autonomous workflows. It provides real email addresses, API & MCP access, signed webhooks, and deliverability guardrails.

How does Gork mail work for AI agents?

Gork mail gives each AI agent its own isolated email address via one API call or MCP tool. Agents can send emails, receive inbound messages via signed webhooks, search conversation history, and manage threads.

Can I use Gork mail with Claude Code, Cursor, or LangChain?

Yes. Gork mail ships a native Model Context Protocol (MCP) server. Running npx -y -p @gork/sdk gork-mcp gives Claude, Cursor, Goose, or Windsurf 13 native email tools.

ElizaOS + Gork Mail

Give ElizaOS its own inbox

Gork Mail is the best way to give ElizaOS its own inbox. Send email, receive replies, and manage full conversation threads from a dedicated inbox each bot owns.

Start for free Docs

Install

One command

Add the Gork MCP server with the command or config below, then restart ElizaOS. 13 email tools appear, each call scoped to the inbox you connect. The same MCP server serves CLI agents, editors, and the Gork API.

1Install the Gork SDK (pip install gork-sdk, or npm i @gork/sdk for TypeScript).

2Add GORK_API_KEY to your character configuration JSON or .env file.

3Start your Eliza agent: pnpm start --characters="characters/assistant.character.json".

4Interact with your agent via Discord, Telegram, or Web client and instruct it to check email.

Run directly in your terminal to install the MCP tool.

pip install gork-sdk  # or: npm i @gork/sdk

Try it

One prompt away

Add to character system prompt or operator chat. Copy it, paste it into ElizaOS — it calls the tools itself.

ElizaOS

Initialize Gork Mail inbox for yourself at domain "yourcompany.com". Poll for incoming unread emails every 15 minutes, filter out spam, and send a daily summary to founder@yourcompany.com.

Paste into ElizaOS — no code, no config

Why email

Why your ElizaOS agent needs its own inbox

One address per bot

Not one connection shared across the fleet. The native Gmail plugin gives every bot on your account the same credential. Gork Mail gives each bot a real address it owns.

Real inbound

The Gmail plugin lets your bot read your inbox. Gork Mail lets people, or systems, email the bot directly, with full thread history and reply_to_message.

Scoped blast radius

One flagged send scopes to one bot's address, not your entire Gmail reputation.

Code

Working code

Action execution within an ElizaOS character (Python SDK):

from gork import Gork
import os

gork = Gork(api_key=os.environ["GORK_API_KEY"])

def send_briefing(to: str) -> str:
    msg = gork.send_message(
        inbox_id=os.environ["GORK_INBOX_ID"],
        to=[to],
        subject="Daily Agent Activity Briefing",
        text="All automated tasks completed successfully for today.",
    )
    return msg["id"]

def unread_count() -> int:
    return len(gork.list_messages(inbox_id=os.environ["GORK_INBOX_ID"], limit=50))

Templates

Live ElizaOS bots, each running on its own Gork Mail inbox. Open one to add it to your account and email it.

Sales

Lead

Qualifies inbound demo email. Replies with times or a self-serve link.

Prompt Trigger

“Monitor incoming sales inquiries on partnerships@yourcompany.com. If an enterprise lead emails, evaluate company size and reply with demo calendar links.”

Gork Mail

Support

Desk

Tier-one support inbox. Answers from your FAQ, escalates the rest.

Prompt Trigger

“Check support@yourcompany.com for unread tickets. Draft answers using our knowledge base and tag human engineers on billing disputes.”

Gork Mail

Engineering

Crash Triage

Ingests CI/CD crash dumps and error emails, locates the failing code, and opens a pull request.

Prompt Trigger

“Read incoming error emails from Sentry on alerts@yourcompany.com, parse the stack trace, locate the bug in our codebase, and reply with the commit fix.”

Gork Mail

Operations

Approval Gate

Human-in-the-loop send gate. Intercepts OTP codes or confirms actions.

Prompt Trigger

“Listen on verify-bot@yourcompany.com for authentication emails. Extract the 6-digit confirmation code and print it to complete automated signup.”

Gork Mail

Productivity

Scheduler

Negotiates meeting times over email until everyone agrees.

Prompt Trigger

“Coordinate meeting availability with external clients on schedule@yourcompany.com. Propose 3 alternate time slots and confirm upon agreement.”

Gork Mail

Executive

Threadmate

CC it on a thread. Reads the history and replies from your brief.

Prompt Trigger

“When CCed on email threads, summarize recent correspondence and draft a concise executive response for my review.”

Gork Mail

FAQ

Common questions about Gork Mail and ElizaOS.

ElizaOS has no built-in mail polling — have your character call search_messages on an interval, or point a Gork webhook at your agent server so new mail wakes it up.