Install

Every installer, and the terminal way.

The desktop app walks you through all three steps. Here is everything else: the installer for each system, the core alone with pip, and the commands to connect a mailbox and an agent by hand.

Step 1

Get GigaMail

One installer with its own Python: no prerequisites, no administrator password, updates itself.

Windows 10 / 11GigaMail-Setup.exe macOS, Apple SiliconGigaMail-arm64.dmg macOS, IntelGigaMail-x64.dmg Linux, Debian / Ubuntu betaGigaMail-amd64.deb Linux, AppImage betaGigaMail-x86_64.AppImage

Windows signed, macOS signed and notarized; the Linux packages are a beta and not signed (on Ubuntu 23.10 and later use the .deb). SHA-256 digests on the release page. No graphical app needed? The core alone:

pip install "gigamail[all]"

Step 2

Connect your mailbox

In the app, the onboarding does it: Microsoft 365 with a login in your browser, or IMAP with an app password. From the terminal:

gigamail login                # Microsoft 365, device flow
gigamail accounts add-imap    # Gmail, Aruba, Libero, ...
gigamail check                # a search, a draft held for you

Then say who replies: identity, tone, and the files the agent may quote.

gigamail identity set
gigamail identity add-file ./pricelist.xlsx

Credentials go through you, in your own shell. There is no tool an agent could use to add an account.

Step 3

Connect your agent

GigaMail has no AI of its own: the intelligence is the agent you connect. The app's third step copies the exact config for you; by hand it is one of these.

The repository is a Claude Code plugin: it registers the server and adds a skill that teaches Claude the approval gate.

claude plugin marketplace add adecubed/gigamail
claude plugin install gigamail@gigamail

Add the server to claude_desktop_config.json under mcpServers, then restart Claude Desktop.

{
  "mcpServers": {
    "gigamail": { "command": "gigamail-server" }
  }
}

As a Codex plugin, with the same skill:

codex plugin marketplace add adecubed/gigamail
codex plugin add gigamail@gigamail

Or register the server alone, which is also what the OpenAI Plugins Directory entry expects:

codex mcp add gigamail -- gigamail-server

Using ChatGPT rather than the terminal? The step-by-step guide.

OpenClaw probes the server before saving it. Point GIGAMAIL_ROOT at your GigaMail data folder.

openclaw mcp add gigamail --command gigamail-server \
  --env "GIGAMAIL_ROOT=<your data folder>"
openclaw skills install @adecubed/gigamail   # the approval-gate skill

Hermes passes stdio servers only the environment you declare, so GIGAMAIL_ROOT is required. In ~/.hermes/config.yaml:

mcp_servers:
  gigamail:
    command: "gigamail-server"
    env:
      GIGAMAIL_ROOT: "<your data folder>"

Check with hermes mcp test gigamail.

Any MCP client that can start a stdio server works. Command gigamail-server, no network port, no API key. Declare GIGAMAIL_ROOT if the client filters the environment.

Verified setups, tool filters and how to get approvals on your phone: INTEGRATIONS.md.