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_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

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