Email Archive
Autonomous, searchable email archives. Create archives and link mailboxes (local or external) to them as context sources.
Endpoints (7)
Create a new autonomous email archive owned by an email address.
| Field | Type | Required | Description |
|---|---|---|---|
name |
string | ✓ Yes | Human-friendly archive name (e.g. "M25 mail"). |
owner_email |
string | ✓ Yes | Owner email address. |
description |
string | No | Optional description of what this archive holds. |
List archives with their source counts. Optionally filter by owner email.
| Field | Type | Required | Description |
|---|---|---|---|
owner_email |
string | No | Filter archives by owner email. |
Deactivate an archive. Stops syncing into it; archived messages are preserved.
| Field | Type | Required | Description |
|---|---|---|---|
archive_id |
integer | ✓ Yes | Archive ID to deactivate. |
Register an external mail source (Gmail, Outlook, custom IMAP) for archiving. Credentials are stored encrypted. Link it to an archive separately with link-source.
| Field | Type | Required | Description |
|---|---|---|---|
email |
string | ✓ Yes | Mailbox email address. |
imap_host |
string | ✓ Yes | IMAP server hostname (e.g. "imap.gmail.com"). |
imap_port |
integer | No | IMAP port (default 993 for SSL). |
encryption |
string | No | none, ssl, or starttls (default ssl). |
auth_method |
string | No | password or oauth (default password). |
credential |
string | ✓ Yes | Password or OAuth token — stored encrypted. |
folders |
array | No | Folders to sync (default ["INBOX","Sent"]). |
List all archive sources (mailboxes), or the sources linked to a specific archive. Never returns credentials.
| Field | Type | Required | Description |
|---|---|---|---|
archive_id |
integer | No | If given, list only sources linked to this archive. |
Link a mailbox source to an archive so its mail flows into that archive. A source can feed multiple archives.
| Field | Type | Required | Description |
|---|---|---|---|
archive_id |
integer | ✓ Yes | Target archive ID. |
source_id |
integer | ✓ Yes | Source (mailbox) ID to link. |
Unlink a source from an archive. Stops future syncing into it; already-archived messages are preserved.
| Field | Type | Required | Description |
|---|---|---|---|
archive_id |
integer | ✓ Yes | Archive ID. |
source_id |
integer | ✓ Yes | Source (mailbox) ID to unlink. |
MCP Tool Names
When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:
| Endpoint | MCP Tool Name |
|---|---|
| create-archive | email_archive_create_archive |
| list-archives | email_archive_list_archives |
| deactivate-archive | email_archive_deactivate_archive |
| register-external-source | email_archive_register_external_source |
| list-sources | email_archive_list_sources |
| link-source | email_archive_link_source |
| unlink-source | email_archive_unlink_source |