Outlook Integration for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Outlook MCP or direct API to read, send, and organize emails, manage your calendar, and automate scheduling through natural language.
BOOK A CALLGET STARTED FOR FREE
Outlook Logo
Gradient Top
Gradient Middle
Gradient Bottom
divider

Supported Tools and Triggers

Tools
Triggers
Add mail attachmentTool to add an attachment to an email message.
Create calendarTool to create a new calendar in the signed-in user's mailbox.
Create contact folderTool to create a new contact folder in the user's mailbox.
Create Email RuleCreate email rule filter with conditions and actions
Create mail folderTool to create a new mail folder.
Create master categoryTool to create a new category in the user's master category list.
Delete mail folderDelete a mail folder from the user's mailbox.
Download Outlook attachmentDownloads a specific file attachment from an email message in a microsoft outlook mailbox; the attachment must contain 'contentbytes' (binary data) and not be a link or embedded item.
Get mailbox settingsTool to retrieve mailbox settings.
Get mail deltaTool to retrieve incremental changes (delta) of messages in a mailbox.
Get mail tipsTool to retrieve mail tips such as automatic replies and mailbox full status.
Get master categoriesTool to retrieve the user's master category list.
Get supported languagesTool to retrieve supported languages in the user's mailbox.
Get supported time zonesTool to retrieve supported time zones in the user's mailbox.
List Outlook calendarsTool to list calendars in the signed-in user's mailbox.
List event attachmentsTool to list attachments for a specific outlook calendar event.
List Outlook attachmentsLists metadata (like name, size, and type, but not `contentbytes`) for all attachments of a specified outlook email message.
List event remindersTool to retrieve reminders for events occurring within a specified time range.
Add event attachmentAdds an attachment to a specific outlook calendar event.
Create Calendar EventCreates a new outlook calendar event, ensuring `start datetime` is chronologically before `end datetime`.
Create contactCreates a new contact in a microsoft outlook user's contacts folder.
Create email draftCreates an outlook email draft with subject, body, recipients, and an optional attachment.
Create a draft replyCreates a draft reply in the specified user's outlook mailbox to an existing message (identified by a valid `message id`), optionally including a `comment` and cc/bcc recipients.
Delete ContactPermanently deletes an existing contact, using its `contact id` (obtainable via 'list user contacts' or 'get contact'), from the outlook contacts of the user specified by `user id`.
Delete Calendar EventDeletes an existing calendar event, identified by its unique `event id`, from a specified user's microsoft outlook calendar, with an option to send cancellation notifications to attendees.
Get contactRetrieves a specific outlook contact by its `contact id` from the contacts of a specified `user id` (defaults to 'me' for the authenticated user).
Get contact foldersTool to retrieve a list of contact folders in the signed-in user's mailbox.
Get calendar eventRetrieves the full details of a specific calendar event by its id from a user's outlook calendar, provided the event exists.
Get email messageRetrieves a specific email message by its id from the specified user's outlook mailbox.
Get Outlook profileRetrieves the microsoft outlook profile for a specified user.
Get scheduleRetrieves free/busy schedule information for specified email addresses within a defined time window.
List Outlook contactsRetrieves a user's microsoft outlook contacts, from the default or a specified contact folder.
List eventsRetrieves events from a user's outlook calendar via microsoft graph api, supporting pagination, filtering, property selection, sorting, and timezone specification.
List mail foldersTool to list a user's top-level mail folders.
List MessagesRetrieves a list of email messages from a specified mail folder in an outlook mailbox, with options for filtering (including by conversationid to get all messages in a thread), pagination, and sorting; ensure 'user id' and 'folder' are valid, and all date/time strings are in iso 8601 format.
Move message to folderMove a message to another folder within the specified user's mailbox.
Reply to EmailSends a plain text reply to an outlook email message, identified by `message id`, allowing optional cc and bcc recipients.
Search Outlook messagesSearches messages in a microsoft 365 or enterprise outlook account mailbox, supporting filters for sender, subject, attachments, pagination, and sorting by relevance or date.
Send emailSends an email with subject, body, recipients, and an optional attachment via microsoft graph api; attachments require a non-empty file with valid name and mimetype.
Update calendar eventUpdates specified fields of an existing outlook calendar event.
Update ContactUpdates an existing outlook contact, identified by `contact id` for the specified `user id`, requiring at least one other field to be modified.
Update email messageUpdates specified properties of an existing email message; `message id` must identify a valid message within the specified `user id`'s mailbox.
Update mailbox settingsTool to update mailbox settings for the signed-in user.

Connect Outlook MCP Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio claude-agent-sdk
Install the Composio SDK and Claude Agent SDK

Create Tool Router Session

python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
Initialize the Composio client and create a Tool Router session

Connect to AI Agent

python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Outlook tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Show all events on my calendar for today')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
Use the MCP server with your AI agent

Connect Outlook API Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio_openai
Install the Composio SDK

Initialize Composio and Create Tool Router Session

python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
Import and initialize Composio client, then create a Tool Router session

Execute Outlook Tools via Tool Router with Your Agent

python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Summarize unread emails from today'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
Get tools from Tool Router session and execute Outlook actions with your Agent

Why Use Composio?

AI Native Outlook Integration

  • Supports both Outlook MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Outlook data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Outlook access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Outlook
  • Scoped, least privilege access to Outlook resources
  • Full audit trail of agent actions to support review and compliance

Use Outlook with any AI Agent Framework

Choose a Framework you want to connect Outlook with

Frequently Asked Questions

Do I need my own developer credentials to use Outlook with Composio?

No, you can get started immediately using Composio's built-in Outlook app. For production, we recommend configuring your own OAuth credentials.

Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Used by agents from

Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Book a call↗Get started for free