ox-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OX_MCP_MAIL_USER | No | Mailbox login (email address). | |
| OX_MCP_CALDAV_USER | No | CalDAV login. | |
| OX_MCP_MAIL_SERVER | No | Mail host. For the default ox-api transport this is the OX webmail host (e.g. webmail.example.com). | |
| OX_MCP_CARDDAV_USER | No | CardDAV login. | |
| OX_MCP_CALDAV_SERVER | No | CalDAV host (e.g. dav.example.com). | |
| OX_MCP_CARDDAV_SERVER | No | CardDAV host. | |
| OX_MCP_MAIL_TRANSPORT | No | ox-api (OX HTTP API) or imap (direct IMAP/SMTP). | ox-api |
| OX_MCP_TIMEOUT_SECONDS | No | Optional request timeout in seconds (default 300). | |
| OX_MCP_ENABLE_EMAIL_SEND | No | Enable the write tool email_send (writes are off by default). Similar OX_MCP_ENABLE_* flags exist per tool. | |
| OX_MCP_MAIL_APP_PASSWORD | No | Mail app password. | |
| OX_MCP_CALDAV_APP_PASSWORD | No | CalDAV app password (may be protocol-scoped). | |
| OX_MCP_CARDDAV_APP_PASSWORD | No | CardDAV app password. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_servers | List configured accounts/servers and their mail/calDav/cardDav sections (hosts, users, auth types). Never returns secrets. |
| email_list_folders | List IMAP mailboxes/folders for an account. |
| email_list | List the most recent emails in a folder (newest first). |
| email_read | Read a single email (headers + body) by UID. |
| email_search | Search emails by from/to/subject/body/text, date range, and flags. Searches ALL folders unless a folder is given. Note: on the ox-api transport, |
| email_filter_list | List server-side mail filters managed by ox-mcp (sieve). |
| email_send | Send an email via SMTP. |
| email_save_draft | Compose a message and save it to the Drafts folder (does not send). |
| email_reply | Reply to the sender of an email, threading preserved. |
| email_reply_all | Reply to all recipients of an email (sender + To/Cc, excluding yourself), threading preserved. |
| email_delete | Delete an email by UID (moves to Trash or expunges per server policy). |
| email_move | Move an email by UID to another folder. |
| email_flag | Flag or unflag (star/unstar) an email. |
| email_mark_read | Mark an email as read (sets the \Seen flag). |
| email_mark_unread | Mark an email as unread (clears the \Seen flag). |
| email_mark_spam | Move an email to the account's spam/junk folder (special-use aware). |
| email_archive | Move an email to the account's archive folder (special-use aware). |
| email_create_folder | Create a new IMAP folder. Use the delimiter of the account (usually "/") for nesting, e.g. "Projects/Acme". |
| email_delete_folder | Delete an IMAP folder. The folder and its messages are removed — this cannot be undone. |
| email_filter_create | Create a server-side mail filter (sieve). Note: ox-mcp manages its own sieve script and activates it. |
| email_filter_update | Replace an existing ox-mcp mail filter by id (see email_filter_list). |
| calendar_list | List CalDAV calendars (own and any shared with the account). |
| calendar_list_events | List events in a calendar within a time range. |
| calendar_free_busy | Query attendees' availability (busy/free windows only) via the CalDAV scheduling outbox. No calendar sharing required. |
| calendar_create_event | Create a calendar event (VEVENT) in a calendar. |
| calendar_update_event | Replace an existing calendar event by its object URL. |
| calendar_delete_event | Delete a calendar event by its object URL. |
| calendar_accept_event | Accept a calendar event invitation as this account (sets your PARTSTAT to ACCEPTED; the server notifies the organizer). |
| calendar_decline_event | Decline a calendar event invitation as this account (sets your PARTSTAT to DECLINED; the server notifies the organizer). |
| calendar_tentative_event | Tentatively accept a calendar event invitation as this account (sets your PARTSTAT to TENTATIVE; the server notifies the organizer). |
| contact_list | List all CardDAV contacts. Reads all address books unless one is given. To search, use contact_find instead. |
| contact_find | Search CardDAV contacts by a case-insensitive substring (server-side where supported). Useful for resolving a name to an email address, e.g. before calendar_free_busy. |
| contact_create | Create a CardDAV contact (vCard) in an address book. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Rheopyrin/ox-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server