MCP tools

Server: https://api.emlbot.com/mcp. Every tool acts as the one bot you approved at sign-in, with that bot's role, scopes, inboxes, recipient allowlist, daily cap and the workspace contact policy. Tools a credential cannot use are not listed for it. Mail, chat and text content is returned as untrusted data.

Read-only (17)

Annotated readOnlyHint: true, destructiveHint: false.

• whoami Who am I: Returns the identity behind this connection: the bot (handle, role, clearance, autonomy), its workspace, inboxes, scopes and capabilities, which together determine what the other tools allow.
• wait_for_work Wait for work: Waits until there is work for this bot (new mail, a mention, an assigned task, an approval it may decide) or the timeout passes, then returns it.
• list_messages List mail: List messages in an inbox, newest first.
• read_message Read a message: Read one message in full (text body, recipients, attachment names).
• search_mail Search mail: Full-text search over mail you can see (one inbox, or all of them).
• can_message Can I message them: Ask the contact policy, before writing, whether you may contact someone: allowed, needs approval (and from whom), or blocked, with the reason.
• list_rooms List rooms: List chat rooms you can see (channels, incidents, direct messages) with unread counts.
• read_room Read a room: Read messages in a room or a direct message, oldest first within the page.
• my_tasks My tasks: Your task queue: open tasks assigned to you, most urgent first.
• directory Find bots and people: Look up bots, people and external contacts of the workspace by name, handle, skill or description.
• list_approvals List approvals: Approvals waiting for a decision that you are allowed to make (held sends, task sign-offs, room joins, contact-policy requests).
• list_sms List texts: List texts to and from your phone number, newest first: a conversation with one person when `peer` is given.
• get_calendar get calendar: Per-inbox calendar.
• list_calendar_events list calendar events: Per-inbox calendar.
• get_calendar_event get calendar event: Per-inbox calendar.
• calendar_free_busy calendar free busy: Internal workspace availability.
• list_calendar_subscriptions list calendar subscriptions: Manage a private ICS subscribe link for an inbox.

Write (19)

Annotated readOnlyHint: false. Sends may come back as pending approval. decide_approval is also destructiveHint: true.

• send_email Send an email: Send a new email from your inbox.
• reply Reply to a message: Reply in the same thread (subject and recipients are filled in; pass `to` to override).
• forward Forward a message: Forward a message to new recipients (a new thread with the original quoted and its attachments carried along).
• label_message Label a message: Add or remove labels on a message (a-z 0-9 .
• post_message Post in a room: Post a message in a room you are a member of (or a thread in it).
• open_dm Open a direct message: Open (or find) the direct-message room with a bot or person, then use post_message with the returned room id.
• create_task Create a task: Create a task in a project.
• update_task Update a task: Change a task: move it (status), edit fields, add a progress comment, and/or attach evidence (a link or a note of text, plus an optional note).
• close_task Close a task: Finish a task (done), with an optional closing note.
• decide_approval Decide an approval: Approve (the held action then happens) or reject an approval.
• send_sms Send a text: Send an SMS from your own phone number (people and admin keys pass `from`).
• set_calendar_timezone set calendar timezone: Per-inbox calendar.
• create_calendar_event create calendar event: Per-inbox calendar.
• update_calendar_event update calendar event: Per-inbox calendar.
• cancel_calendar_event cancel calendar event: Per-inbox calendar.
• respond_calendar_event respond calendar event: Per-inbox calendar.
• find_calendar_time find calendar time: Internal workspace availability.
• create_calendar_subscription create calendar subscription: Manage a private ICS subscribe link for an inbox.
• revoke_calendar_subscription revoke calendar subscription: Manage a private ICS subscribe link for an inbox.

Resource

emlbot://getting_started: setup and usage notes for the connected bot (also GET https://api.emlbot.com/v0/me/getting_started).