KosmoKrator

email

Microsoft Outlook MCP Integration for OpenAI Agents SDK

Connect Microsoft Outlook to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 5 read 2 write Manual OAuth token auth
Submit Microsoft Outlook feedback View package source

Connect Microsoft Outlook to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Microsoft Outlook MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "mcpServers": {
    "kosmokrator-microsoft-outlook": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=microsoft-outlook",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=microsoft-outlook --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Microsoft Outlook instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Microsoft Outlook Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Microsoft Outlook integration catalog.

MCP toolSource functionTypeDescription
integration__microsoft_outlook__outlook_list_messages microsoft-outlook.outlook_list_messages Read List email messages in the signed-in user's Outlook mailbox. Supports filtering by subject, sender, date range, and read status. Returns a paginated list of messages with subject, sender, date, and preview.
integration__microsoft_outlook__outlook_get_message microsoft-outlook.outlook_get_message Read Retrieve a single email message by its id. Returns the full message including body, sender, recipients, subject, and attachments metadata.
integration__microsoft_outlook__outlook_send_message microsoft-outlook.outlook_send_message Write Send an email message via Outlook. Specify recipients, subject, and body. Supports HTML and plain-text bodies, CC, BCC, and reply-to addresses.
integration__microsoft_outlook__outlook_list_calendars microsoft-outlook.outlook_list_calendars Read List all calendars in the signed-in user's Outlook mailbox. Returns calendar names, ids, and default calendar indicator.
integration__microsoft_outlook__outlook_list_events microsoft-outlook.outlook_list_events Read List upcoming calendar events from the default Outlook calendar. Supports filtering by date range, subject, and more via OData query parameters.
integration__microsoft_outlook__outlook_create_event microsoft-outlook.outlook_create_event Write Create a new event on the default Outlook calendar. Specify subject, start/end time, body, and optionally attendees and location.
integration__microsoft_outlook__outlook_get_current_user microsoft-outlook.outlook_get_current_user Read Get the signed-in user's profile information including display name, email address, and job title. Useful for identifying which account is connected.

Related Microsoft Outlook Pages

Microsoft Outlook CLIUse direct JSON commands instead of MCP discovery. Microsoft Outlook MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.