macpilot-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MACPILOT_SAFETY_PROFILE | No | Safety profile for mail write tools. Defaults to safe_manage. Set to full_access to enable mail_send_message. | safe_manage |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| mail_statusC | FTS5 index health + stats. |
| mail_list_accountsB | List configured Mail accounts. |
| mail_list_mailboxesB | List mailboxes, optionally for one account. |
| mail_get_emailsC | List emails from one mailbox (disk-first, no full scan). |
| mail_get_emailB | Single email with full content + attachments (disk-first ~3ms). |
| mail_searchB | FTS5 full-mailbox search with BM25 ranking. Index required for body scope. |
| mail_get_linksC | Extract hyperlinks from one email. |
| mail_index_rebuildC | (Re)build the FTS5 index from disk. Run again when the index is stale. |
| mail_send_messageB | Send email (full_access safety profile required). |
| mail_move_messageC | Move/archive a message. |
| mail_mark_messageC | Mark read/unread. |
| calendar_list_eventsD | Events in window (ISO datetimes). |
| reminders_listC | Open reminders, optionally in one list. |
| contacts_searchB | Search contacts by name/email/phone. |
| macpilot_healthC | Server health across domains. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 15 tools
Most tools target a distinct resource+action within a clear domain prefix (mail, calendar, reminders, contacts). The main confusion risk is mail_get_email vs mail_get_emails and mail_search vs mail_get_emails, where plural/singular and list-vs-search boundaries are only resolved by reading descriptions. mail_get_links also partially overlaps with what mail_get_email already returns.
Strong, predictable snake_case domain_action pattern (mail_*, calendar_*, contacts_*), which makes scanning easy. Minor deviations: mail_status and macpilot_health are noun-only with no verb, and reminders_list reverses the verb_noun order used by calendar_list_events and mail_list_*.
15 tools is at the top of the comfortable range and each mail tool earns its place; index maintenance and health checks are justified given the FTS5 dependency. The surface is a bit mail-heavy relative to the four other domains, which get only a single tool each.
Mail coverage is strong (accounts, mailboxes, list/get/search, links, index rebuild, send, move, mark), though delete and reply/forward are absent. Calendar, reminders, and contacts are read-only, so common agent tasks like creating an event or completing a reminder are impossible — a notable lifecycle gap.