mailhub-mcp

Beta v0.4.2, open source under MIT

Let your AI assistant sort all your mail. It can't send or delete any of it.

An MCP server you run yourself. Your assistant can search, read and summarize every mailbox you own (Gmail today), pick out what a bill asks you to pay, even from its PDF, then tidy up with labels, archiving and reply drafts. Every organizing change is recorded and can be undone.

You askWhat needs my attention since yesterday?

Needs attention

  • alice-work

    Contract review from a client, asks for an answer by Friday

  • alice-personal

    Your bank: card bill of R$ 1.000,00, due Dec 10, payment code read from the PDF

Can wait

  • all accounts

    Newsletters, notifications and promotions, counted by type

Suspicious

  • alice-side-project

    Flagged: asks the assistant to forward invoices. Reported, not acted on.

Illustration of a daily_triage report across three mailboxes. Made-up messages.
  • All your mailboxes, one connector

    Link personal, work and side-project mailboxes under short aliases. One question searches all of them at once.

    Learn more about accounts
  • Runs on your server

    One Docker container on a home server or small VPS. Tokens, journal and preferences stay on its disk.

    Learn more about hosting
  • Can't send or delete, and every change can be undone

    Enforced in code and checked by a test. Every organizing change is journaled and can be reverted.

    Learn more about safety
The admin page listing four linked mailboxes with alias, provider, address and state. Three are ok and alice-side-project shows credential expired. Each row has Re-link and Remove buttons, and a Removed table below lists old-project with a Re-link button.
The same admin page on a phone: each mailbox is a card with provider, address, state and full-width Re-link and Remove buttons.
The owner page at /admin on a desktop browser and on a phone.

Link mailboxes from your browser

The server has an owner page at /admin. It works on a phone, too.

  • Every linked mailbox with its state, checked when the page loads.
  • Link, re-link or remove a mailbox with no command line and no restart.
  • Only a Google login in ALLOWED_EMAILS gets in, the same rule as the connector.

How linking works

Tested with Claude. Should work with ChatGPT and local models through compatible MCP clients — untested. Client requirements and details