← Plugin catalog
Communication

GigaMail

Adecubed v0.3.3

Answer email from your files

Create a free account to save this plugin.

From the developer

Declared capabilities

  • Read, search and triage mail across Microsoft 365 and IMAP accounts
  • Extract attachment text (PDF, DOCX, XLSX) without passing binaries to the model
  • Draft replies from the account's identity and knowledge files

Not specified in the available declarations: limitations, pricing & account requirements.

Onboarding example

Triage my unread mail and tell me what needs an answer today
Sources & dates

Developer declarations; not independently tested. Listing last checked Nov 16, 2026. Package observed Nov 15, 2026.

View package source →

Description

From the marketplace listing

GigaMail connects Codex to your real mailboxes, Microsoft 365 or any IMAP provider, and to your calendar, and answers mail the way you would: from your own identity and your own documents. Tell it once who you are, what you do and how you sign; attach your price list, catalogue, terms or product sheets to the account. When a request comes in, Codex reads the thread and what was already said to that sender, takes the numbers from your files instead of inventing them, checks your free slots before proposing a time, and drafts the reply in the language the customer wrote in. Several mailboxes work side by side, one agent across all of them. Nothing goes out on the agent's say-so: every send, reply, delete or calendar write waits for your approval, from the desktop console, the CLI or Telegram, and mail content is treated as data, never as instructions. The server runs on your machine (pip install "gigamail[all]"); this skill teaches Codex how to use it.

Language: English · Automatically detected from descriptions.

What changed

Keywords

Files & skills

File archives

Plugin package10 files · 187 KBBrowse files →
Skill instructions
gigamail8.85 KB

View saved version →

---
name: gigamail
description: "Email and calendar on the user's real mailbox (Microsoft 365 or IMAP) through the GigaMail MCP server. Use when asked to read, triage or search mail, read attachments, draft or send replies, check availability, or propose and book appointments. Every send, delete and calendar write is held for out-of-band human approval that the agent cannot grant itself."
---

# GigaMail

GigaMail gives you the user's real mailboxes and calendar as 28 typed MCP
tools on the `gigamail` server. Reading, searching, attachment text, sender
history, free-slot computation and drafting are free. Sending, replying,
deleting and calendar writes are **two-phase**: the first call returns an
inert `request_id` and a preview, a human approves it out of band (desktop
console, CLI or Telegram, behind Windows Hello / Touch ID), and only then a
second call with that `request_id` executes what was stored at request
time. There is no tool that grants approval. This skill tells you how to
work with that gate, not around it.

Codex has its own approval prompt in interactive sessions: that is a first,
client-side fence. GigaMail's gate is server-side and holds even when
Codex's approvals and sandbox are bypassed. Both are meant to be there.

## Setup (once, by the human)

1. Install the server (Python 3.10+). The plugin does not ship it:

   ```bash
   pip install "gigamail[all]"
   ```

2. Connect a mailbox. **CLI only, by design**: credentials never pass
   through the agent channel, so tell the user what to run and wait.

   ```bash
   gigamail login                # Microsoft 365, device flow
   gigamail accounts add-imap    # any IMAP provider
   ```

3. Make the `gigamail` MCP server known to Codex. Two cases:

   - Installed from the repository marketplace, the plugin registers the
     server itself from its `.mcp.json`; nothing to do:

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

   - Installed from the Plugin Directory (skill only, no server bundled),
     register it once:

     ```bash
     codex mcp add gigamail -- gigamail-server
     ```

   Check with `codex mcp list`: the `gigamail` server must be enabled.

4. Optional but valuable: an identity (who the user is, what they do, how
   they sign) and knowledge files (price lists, catalogues, terms). Replies
   are drafted from those.

   ```bash
   gigamail identity set
   gigamail identity add-file C:\docs\pricelist.xlsx
   ```

5. Optional: the GigaMail desktop console (Windows installer on GitHub
   Releases) is where the user reads mail, approves your requests and
   manages reply rules. Server and console must share the data directory:
   `%APPDATA%\ADE` on Windows, `~/.ade` elsewhere, or the same
   `GIGAMAIL_ROOT`. From the repository marketplace the plugin forwards
   `APPDATA`, `GIGAMAIL_ROOT` and `ADE_ROOT` to the server; with
   `codex mcp add`, pass the directory explicitly if the server sees no
   accounts: `codex mcp add gigamail --env GIGAMAIL_ROOT=<dir> -- gigamail-server`.

Start a new Codex session after installing: MCP tools load at startup.

## The 28 tools, by class

- **Read** (17), free to call: `list_accounts`, `get_identity`,
  `list_knowledge_files`, `read_knowledge_file`, `list_messages`,
  `list_unread`, `read_message`, `read_attachment`, `list_folders`,
  `search_mail`, `sender_history`, `observer_context`, `memory_stats`,
  `list_events`, `find_free_slots`, `drive_list_files`, `drive_read_file`.
- **Safe writes** (2), free to call, audited: `mark_read`, `create_folder`.
- **Dangerous** (9), two-phase with a human in between: `send_mail`,
  `reply_mail`, `delete_message`, `delete_folder`, `move_message`,
  `create_event`, `delete_event`, `drive_upload_file`,
  `drive_delete_file`.

## The approval gate: read this before acting

How a dangerous tool works:

1. Call it **without** 

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 3 — file references are metadata, not package contents.

Package details

Publisher declarations from the archived package. These are separate from our research and the live service's terms.

Package license
AGPL-3.0-or-later
Package author
Adecubed
Keywords
See keywords

Declared capabilities

  • Read, search and triage mail across Microsoft 365 and IMAP accounts
  • Extract attachment text (PDF, DOCX, XLSX) without passing binaries to the model
  • Draft replies from the account's identity and knowledge files
  • Compute free calendar slots and manage events
  • Out-of-band human approval for send, reply, delete and calendar writes

Package observed Nov 15, 2026.

Technical details
First seen
Sep 30, 2026 · 22:02 UTC
Last seen
Nov 16, 2026 · 00:00 UTC
Collection status
Collected

plugins_6aa41ff2b150819181fcdf4c944933a3

Download plugin data (JSON)

Plugin details: freshly prepared. Prepared . Refreshed when plugin data changes or after 6 hours. Your account and Follow status are live.