# Microsoft Outlook MCP for your agent. AI Agent Connect

> Microsoft Outlook MCP gives your AI client direct access to your Microsoft Graph data. It turns your agent into a capable assistant that can triage your inbox, draft and send replies, and manage your entire calendar. You can search through specific folders, schedule new meetings with attendees, and handle meeting cancellations or rescheduling through a single, secure connection.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_iaBBPgpdlBENjlwVdbfRK0dMiBoNIaZUuJenRgvy/ai-agent-connect
- **Tags:** email-management, calendar-management, outlook, microsoft-365, meeting-scheduling

## Description

You can connect your Microsoft Outlook mailbox and calendar to any MCP-compatible client like Claude, Cursor, or Windsurf. This MCP uses the Microsoft Graph API to let your agent act as a functional mail and scheduling associate. Instead of manually digging through threads, you can ask your agent to scan your inbox for specific unread messages or summarize long conversations. It handles the heavy lifting of email management, from drafting replies with full conversation context to sending new messages to multiple recipients. On the scheduling side, your agent can manage your time by listing upcoming events, creating new meetings with invited attendees, or rescheduling existing appointments. It even handles the housekeeping, like deleting old messages or canceling meetings. You get a dedicated agent that stays on top of your threads and keeps your calendar organized while you focus on other work.

## Tools

### create_calendar_event
Schedule a new calendar event by providing a subject and UTC start and end times. You can include attendees via email addresses to send them automatic invitations.

### delete_calendar_event
Remove a calendar event from your schedule. It is better to use the update tool to cancel an event, but this tool handles permanent deletions.

### delete_message
Permanently remove an Outlook message. This action cannot be undone through the API, so your agent should confirm the message ID with you first.

### list_calendar_events
Retrieve a list of your calendar events within a specific time window. It defaults to the next 7 days if you do not specify a range.

### list_messages
Scan or summarize your inbox by listing messages from a specific folder. You can use KQL filters to find unread mail or messages from specific senders.

### read_message
Get the full text and content of a specific email. This tool pulls the message body and can include attachment metadata when requested.

### reply_message
Answer an existing email thread. You can choose to reply to just the sender or use the reply-all option to include everyone in the conversation.

### send_message
Compose and send a brand new email. You can send plain text or HTML and include multiple recipients in a single message.

### update_calendar_event
Modify an existing meeting by changing the time, name, or status. Setting the cancellation flag notifies all attendees automatically.

## Prompt Examples

**Prompt:** 
```
Check my inbox for unread messages from the marketing team and summarize them.
```

**Response:** 
```
Found 4 unread messages from marketing@yoursite.com. 1) The launch page is live as of 09:00, 2) The Q4 budget doc was updated, 3) A meeting invite conflict on Friday was moved to Monday, 4) Two testimonials are ready for the website. Want me to reply to any of them?
```

**Prompt:** 
```
Find the 'Q3 forecast' email, open it, and schedule a review with finance@company.com for next Tuesday at 10am UTC.
```

**Response:** 
```
I opened the forecast thread (3 emails, latest from Dana, 12 Sep). Created the event 'Q3 Forecast Review' on your calendar for next Tuesday 10:00 to 11:00 UTC with finance@company.com invited. The invite is on its way.
```

**Prompt:** 
```
Show me today's meetings and cancel the ones after 3pm.
```

**Response:** 
```
You have 5 meetings today. Cancelled: 'Ops sync' (15:30) and 'Vendor call' (16:00). Keeping: standup, design review, 1:1 with Priya.
```

## Capabilities

### Inbox Triage
Your agent uses KQL filters to find, read, and summarize specific emails or unread threads.

### Email Communication
The agent drafts, replies to, and sends new messages using your Outlook account.

### Calendar Management
Your agent lists, creates, and modifies calendar events to keep your schedule updated.

### Meeting Coordination
The agent invites attendees to new meetings or notifies them when you reschedule or cancel an event.

### Mailbox Cleanup
Your agent can delete specific messages or events when you explicitly request it.

## Use Cases

### Email Summarization
Ask your agent to scan your unread messages and give you a bulleted list of what matters most.

### Meeting Scheduling
Tell your agent to find a time for a meeting and send the invites to all necessary participants.

### Inbox Management
Have your agent find specific old emails or clean up your inbox by deleting unwanted messages.

### Schedule Adjustments
Quickly reschedule or cancel meetings by telling your agent which events to move.

## Benefits

- Reduces manual inbox searching using KQL filtering.
- Automates meeting invites and attendee notifications.
- Maintains conversation context when drafting replies.
- Centralizes mail and calendar control within your AI client.

## How It Works

Connecting to your Outlook data is a straightforward process managed by Vinkius.

1. Register an Entra application with the necessary Microsoft Graph permissions.
2. Subscribe to the MCP on Vinkius.
3. Connect your Outlook account via the OAuth 2.0 prompt.
4. Start giving commands to your AI client to manage your mail and calendar.

## Frequently Asked Questions

**How do I connect my Outlook account?**
You subscribe to the MCP on Vinkius and then connect your account through a standard OAuth 2.0 flow. This handles all the credentials securely.

**Which AI clients can use this MCP?**
Any MCP-compatible client works, including Claude, Cursor, Windsurf, and VS Code.

**Can my agent send emails on my behalf?**
Yes, the agent can compose new messages, reply to existing threads, or use reply-all to respond to groups.

**Does the agent have access to my calendar?**
Yes, it can list your events, create new meetings, and reschedule or cancel existing ones.

**Is deleting a message permanent?**
The delete_message tool removes messages permanently and they cannot be recovered via the API. The agent is designed to confirm with you before doing this.

**Which Microsoft Graph permissions does the account need?**
The app registration needs delegated permissions: Mail.Read, Mail.Send, Mail.ReadWrite, Calendar.Read and Calendar.ReadWrite, plus openid/profile/offline_access. You consent once at the OAuth step; the agent then acts strictly on your own mailbox and calendar.

**Does it work with personal Microsoft accounts, or only work/school accounts?**
Both. The OAuth flow uses the multi-tenant common authority, so personal Microsoft accounts and work or school accounts (Microsoft Entra) can connect — the same scopes apply in both cases.

**Can the agent delete a lot of mail at once?**
Deletion is always per-message by explicit ID, never a bulk operation. The agent lists messages first, then deletes one at a time — which keeps the action auditable and reversible only in the way the mailbox itself allows.
