Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OX_MCP_MAIL_USERNoMailbox login (email address).
OX_MCP_CALDAV_USERNoCalDAV login.
OX_MCP_MAIL_SERVERNoMail host. For the default ox-api transport this is the OX webmail host (e.g. webmail.example.com).
OX_MCP_CARDDAV_USERNoCardDAV login.
OX_MCP_CALDAV_SERVERNoCalDAV host (e.g. dav.example.com).
OX_MCP_CARDDAV_SERVERNoCardDAV host.
OX_MCP_MAIL_TRANSPORTNoox-api (OX HTTP API) or imap (direct IMAP/SMTP).ox-api
OX_MCP_TIMEOUT_SECONDSNoOptional request timeout in seconds (default 300).
OX_MCP_ENABLE_EMAIL_SENDNoEnable the write tool email_send (writes are off by default). Similar OX_MCP_ENABLE_* flags exist per tool.
OX_MCP_MAIL_APP_PASSWORDNoMail app password.
OX_MCP_CALDAV_APP_PASSWORDNoCalDAV app password (may be protocol-scoped).
OX_MCP_CARDDAV_APP_PASSWORDNoCardDAV app password.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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, body/text match only the subject and addresses of recent messages (not full message bodies); use the imap transport for true full-text search.

email_filter_listA

List server-side mail filters managed by ox-mcp (sieve).

email_sendC

Send an email via SMTP.

email_save_draftA

Compose a message and save it to the Drafts folder (does not send).

email_replyB

Reply to the sender of an email, threading preserved.

email_reply_allA

Reply to all recipients of an email (sender + To/Cc, excluding yourself), threading preserved.

email_deleteA

Delete an email by UID (moves to Trash or expunges per server policy).

email_moveA

Move an email by UID to another folder.

email_flagC

Flag or unflag (star/unstar) an email.

email_mark_readC

Mark an email as read (sets the \Seen flag).

email_mark_unreadC

Mark an email as unread (clears the \Seen flag).

email_mark_spamA

Move an email to the account's spam/junk folder (special-use aware).

email_archiveB

Move an email to the account's archive folder (special-use aware).

email_create_folderA

Create a new IMAP folder. Use the delimiter of the account (usually "/") for nesting, e.g. "Projects/Acme".

email_delete_folderA

Delete an IMAP folder. The folder and its messages are removed — this cannot be undone.

email_filter_createA

Create a server-side mail filter (sieve). Note: ox-mcp manages its own sieve script and activates it.

email_filter_updateA

Replace an existing ox-mcp mail filter by id (see email_filter_list).

calendar_listA

List CalDAV calendars (own and any shared with the account).

calendar_list_eventsB

List events in a calendar within a time range.

calendar_free_busyA

Query attendees' availability (busy/free windows only) via the CalDAV scheduling outbox. No calendar sharing required.

calendar_create_eventC

Create a calendar event (VEVENT) in a calendar.

calendar_update_eventB

Replace an existing calendar event by its object URL.

calendar_delete_eventB

Delete a calendar event by its object URL.

calendar_accept_eventA

Accept a calendar event invitation as this account (sets your PARTSTAT to ACCEPTED; the server notifies the organizer).

calendar_decline_eventA

Decline a calendar event invitation as this account (sets your PARTSTAT to DECLINED; the server notifies the organizer).

calendar_tentative_eventA

Tentatively accept a calendar event invitation as this account (sets your PARTSTAT to TENTATIVE; the server notifies the organizer).

contact_listA

List all CardDAV contacts. Reads all address books unless one is given. To search, use contact_find instead.

contact_findA

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_createB

Create a CardDAV contact (vCard) in an address book.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

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