Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OUTLOOK_AUTHNoForce a token source: azure-cli, token, token-file, command, or cookie.auto
OUTLOOK_DEBUGNoSet to 1 to log each request (action and status only) to stderr.off
OUTLOOK_CANARYNoCanary value used together with OUTLOOK_COOKIE.
OUTLOOK_COOKIENoExperimental, untested OWA cookie used as an authentication source.
OUTLOOK_ORIGINNoOWA origin.https://outlook.cloud.microsoft
OUTLOOK_TIMEZONENoWindows time zone ID (e.g. GMT Standard Time) used for times given without an offset. Defaults to the mailbox setting.
OUTLOOK_AZ_TENANTNoOptional tenant passed to the Azure CLI token source (the default authentication source).
OUTLOOK_READ_ONLYNoSet to 1 to register only the 15 read-only tools.off
OUTLOOK_TOKEN_FILENoPath to a file containing a raw token or JSON with accessToken/access_token. Re-read when expired or rejected.
OUTLOOK_ACCESS_TOKENNoStatic bearer token with audience https://outlook.office.com. Must be replaced when it expires (~1 hour).
OUTLOOK_TOKEN_COMMANDNoCommand that prints a token or JSON. Re-run when the token expires or is rejected.
OUTLOOK_ANCHOR_MAILBOXNoOverride the X-AnchorMailbox routing header (defaults to the value derived from the token, e.g. PUID:…@tenant).
OUTLOOK_MAX_DOWNLOAD_MBNoMaximum attachment size in MB for downloads and uploads.25
OUTLOOK_ATTACHMENTS_ORIGINNoAttachment download host.https://attachments.office.net
OUTLOOK_REQUEST_TIMEOUT_MSNoPer-request timeout in milliseconds.30000

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Tools for the user's Microsoft 365 Outlook mailbox (mail, calendar, contacts) via Outlook on the web. IDs returned by one tool can be passed to others. Times in results are UTC; call get_mailbox_info for the user's time zone. send_message, reply_message, forward_message, send_draft, create_event with attendees, update_event, delete_event and respond_to_event contact other people — confirm with the user before using them. Prefer create_draft when the user has not explicitly asked to send.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_mailbox_infoA

Get the signed-in user's name, email address, time zone (Windows ID, used for times given without an offset), storage quota, and inbox/drafts counts.

list_categoriesA

List the mailbox's category names and colors (for categorize_messages and events).

list_foldersA

List mailbox folders with their paths, IDs, well-known names and item/unread counts. Use the returned path or ID wherever a folder is expected.

create_folderB

Create a mail folder, optionally inside another folder.

rename_folderC

Rename a folder.

move_folderB

Move a folder (with its contents) into another folder.

delete_folderA

Delete a folder and everything in it. By default it is moved to Deleted Items; built-in folders cannot be deleted.

list_messagesA

List messages in a folder, newest first, with sender, subject, preview, read/flag state and IDs. Page with offset/nextOffset. Times are UTC.

search_messagesA

Find messages by text, sender, recipient, subject, date, category, read/flag state or attachments. Works by scanning the newest messages of each folder (scanLimit per folder) and matching subject, sender, recipient display names and the ~250-character preview; it does not search full bodies or attachment contents. All given criteria must match. Searches all mail folders except Deleted Items, Junk, Drafts and Outbox unless folders is given.

get_messageA

Get a message with full body (a string; see bodyFormat), recipients and file attachments (inline images are only counted; list_attachments shows them). Does not mark it read unless markAsRead is true.

get_threadA

Get every message in a conversation (across folders), oldest first. Each body contains only the new text of that message, without quoted history.

send_messageA

Compose and immediately send a new email (a copy is saved in Sent Items). Use create_draft instead if the user wants to review it first.

create_draftA

Save a new email in Drafts without sending it. Returns the draft ID for update_draft, add_attachment and send_draft.

update_draftA

Change a draft's subject, body, importance or recipients. Recipient lists replace the existing ones; an empty list clears them.

send_draftB

Send an existing draft (including reply/forward drafts).

reply_messageA

Reply (or reply-all) to a message. The original is quoted below your text. Sends immediately unless send is false, in which case a draft is saved and its ID returned.

forward_messageB

Forward a message (with its attachments) to new recipients. Sends immediately unless send is false.

mark_messages_readB

Mark messages as read or unread (no read receipts are sent).

flag_messagesC

Set the follow-up flag on messages.

categorize_messagesA

Set, add or remove categories on messages. See list_categories for the mailbox's category names.

move_messagesB

Move messages to another folder (e.g. archive). Message IDs stay valid after moving.

copy_messagesB

Copy messages to another folder; returns the IDs of the copies.

delete_messagesA

Delete messages. By default they are moved to Deleted Items (recoverable); permanent deletion cannot be undone.

list_attachmentsC

List the attachments of a message, event or contact.

download_attachmentA

Download a file attachment. With savePath the file is written to disk; otherwise text files are returned as text, images as images, and other files as an embedded base64 resource (up to 10 MB).

add_attachmentB

Attach a file to a draft (or to an event/contact you own).

remove_attachmentA

Remove an attachment from a draft (or from an event/contact you own).

list_calendarsB

List the mailbox's calendars (the default one is wellKnownName "calendar").

list_eventsA

List calendar events (recurring events are expanded into occurrences) that overlap a time range, sorted by start. Defaults to the next 7 days from today (UTC). Returned times are UTC.

get_eventA

Get full event details: description, attendees with their responses, organizer, online meeting link, recurrence master.

create_eventA

Create a calendar event. If attendees are given this is a meeting and invitations are emailed to them immediately. Set isOnlineMeeting to add a Microsoft Teams link (if the tenant allows it).

update_eventA

Change an event you organize. Only given fields change; attendee lists replace the existing ones. For meetings, attendees are sent an update unless notifyAttendees is false.

delete_eventA

Delete an event. For meetings you organize, attendees are sent a cancellation unless notifyAttendees is false. To decline someone else's meeting, use respond_to_event instead.

respond_to_eventA

Accept, tentatively accept or decline a meeting invitation, optionally with a message to the organizer.

list_contactsA

List personal contacts alphabetically. Use search_people to find people by name, including the organization directory.

get_contactB

Get all details of a personal contact.

search_peopleA

Find people by name or email address in the organization directory (global address list) and/or personal contacts. Useful for looking up someone's email address before sending.

create_contactC

Create a personal contact.

update_contactA

Update a personal contact. Only given fields change; an empty string clears a field and emails replaces all addresses.

delete_contactA

Delete a personal contact (moved to Deleted Items unless permanent).

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.4/5.0

Scored across 40 tools

Disambiguation5/5

Tools are cleanly separated along resource+action lines: message read paths (list/search/get/get_thread), draft lifecycle (create/update/send_draft vs send_message/reply/forward), and folder/calendar/contact operations never collide. Near-overlaps like delete_messages vs move_messages or search_people vs list_contacts are explicitly disambiguated in the descriptions, and even attachment listing vs downloading is distinguished.

Naming Consistency5/5

Every tool follows a strict snake_case verb_noun pattern (list_folders, get_message, create_event, delete_contact, mark_messages_read). Plurals and resource nouns are used consistently so the target object is always obvious from the name.

Tool Count2/5

40 tools is well above the well-scoped range; the surface is large because it spans mail, drafts, folders, attachments, calendar, contacts and categories in one server. Each tool is individually justified, but the volume forces an agent to sift through a broad catalog for routine tasks.

Completeness4/5

Lifecycle coverage is strong: mail read/search/send/draft/reply/forward/flag/categorize/move/copy/delete, folder CRUD+move, attachment add/remove/list/download, event CRUD plus respond_to_event, and contact CRUD plus directory search. Remaining gaps are peripheral (inbox rules, out-of-office, creating/deleting categories or calendars, bulk event ops).

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues