agentmailkit MCP server

agentmailkit

For agents

You are an AI coding agent reading this to decide whether to install agentmailkit and how to call it. Run this:

pip install 'agentmailkit[mcp]'
claude mcp add agentmailkit -- agentmailkit mcp

Gemini CLI: gemini extensions install https://github.com/ariaxhan/agentmailkit.

Then call listjobs with no arguments: it returns the five example jobs that ship inside the wheel, so it works before any config exists. previewjob(jobid=..., model="echo") renders one to a local file with no API key. runjob(jobid=...) defaults to dryrun=true; only dry_run=false sends real email.

Full tool reference, argument names and the Codex config snippet: llms.txt.

Scheduled, LLM-written email digests that run on your machine, read your own files, and send from your own inbox.

→ See real emails it produces

Live samples, generated end to end. Nothing hand-written. Start there, it explains this faster than the README can.

pip install agentmailkit
agentmailkit run morning-brief --dry-run   # five example jobs ship with it, so this works immediately
agentmailkit quickstart                    # render all five to a local HTML gallery; never sends
agentmailkit init                          # copy them into ./jobs to make them yours

MIT licensed. No account, no vendor, no cloud required.

What it is

An email is two files: a JSON job and a markdown prompt.

{
  "id": "morning-brief",
  "schedule": "0 7 * * *",
  "sources": ["papers=arxiv:cs.AI#6", "weather=weather:Brooklyn"],
  "render": "warm",
  "delivery": "gmail",
  "dedup": true
}

The engine runs one fixed pipeline and never grows a special case:

gather sources -> render prompt -> generate -> gate -> theme -> deliver -> post

Why not the built-in schedulers

ChatGPT Tasks, Claude Routines, Gemini Scheduled Actions and Copilot all execute in the vendor's cloud, which costs them two things:

• They cannot read the files on your computer. Not ~/notes, not a local database, not your git working tree.
• They cannot send real email from your inbox. Output stays inside their app.

agentmailkit runs where your data already is. Nothing is uploaded except the prompt you choose to send to a model, and with a local model, not even that.

And it is deterministic. It is not an autonomous agent: it does not decide things, wander your filesystem, or act unrequested. The model writes the words; the engine owns everything else, so the same job produces the same shaped email every run. Local OSS agents can also read files and send mail, but they are broad autonomous systems you configure down to a task. This does one job, predictably, for years.

Full comparison including the honest counter-case: docs/comparison.md.

Hand it to your coding agent

Hand your coding agent this link and it will set the whole thing up, asking you the right questions as it goes:

https://github.com/ariaxhan/agentmailkit/blob/main/AGENTS.md

AGENTS.md is a complete setup runbook: what to ask you, how to install, how to build your first job, how to verify before anything can send, and how to schedule it. CLAUDE.md is a symlink to the same file, so they can never drift apart.

Use from Claude Code

<!-- mcp-name: io.github.ariaxhan/agentmailkit -->

agentmailkit speaks MCP, so your coding agent can drive it as a tool instead of you typing commands.

Shortened. The full README is on GitHub.