Graph Mail and Calendar MCP connector for Copilot Studio

March 10, 2026

Microsoft updated the official Work IQ Mail and Work IQ Calendar MCP servers yesterday. Together they provide 21 tools covering core Outlook scenarios. But when your Copilot Studio agent needs to manage attachments, organize folders, create inbox rules, or draft emails that sound like you wrote them—you need more.

This connector delivers 77 MCP tools that cover everything Work IQ offers, plus 50+ additional capabilities for production-grade mail and calendar automation.

What the official servers cover

The Work IQ Mail server (10 tools) handles:

• Create drafts, send, reply, reply-all
• Get, update, delete messages
• List sent items
• Search messages with KQL

The Work IQ Calendar server (11 tools) handles:

• Create, update, delete events
• Accept, decline, cancel invitations
• Find meeting times and check availability
• List events and calendar view

These work well for straightforward scenarios. But real-world agents need deeper control.

What this connector adds

Complete attachment support

Work IQ can’t touch attachments. This connector lets your agent list, read, add, and remove them:

Same operations exist for calendar event attachments—your agent can add meeting agendas or download shared files.

Mail folder management

Organize messages programmatically:

Inbox rules

Automate mail processing:

Draft workflows

Create and manage drafts before sending:

Calendar management

Beyond events—manage calendars themselves:

Mail tips

Know before you send:

Voice-matched email drafting

The killer feature: two composite tools that help agents write emails that sound like you.

get_writing_samples

Fetches recent sent emails to analyze writing patterns:

• Greeting and closing styles
• Formality level
• Sentence structure and vocabulary
• Tone and voice characteristics

Parameters let you filter by recipient (for relationship-aware matching) or topic keyword.

draft_with_style_guide

Combines your company’s writing guidelines with personal voice analysis. When conflicts arise:

• Style guide wins for formal/external communications
• Personal voice wins for casual/internal messages

Example workflows

Reply in your voice:

“Reply to this email in my style” → Agent calls get_writing_samples → analyzes patterns → drafts reply matching your tone

Follow company guidelines:

“Write a budget request using our style guide” → Agent calls draft_with_style_guide with your rules → produces compliant draft

Executive communications:

“Draft an all-hands email about the new initiative” → Agent fetches previous all-hands samples → captures your leadership voice → drafts announcement

Search everywhere

Every list operation supports $search:

• list_messages
• list_sent
• list_folders
• list_folder_messages
• list_events
• list_calendars
• list_users
• list_people

Plus full KQL search via search_messages:

subject:quarterly AND from:john
hasAttachment:true AND received>=2025-01-01
"exact phrase match"

Complete comparison

Work IQ Mail (10 tools)

Work IQ Calendar (11 tools)

Additional tools beyond Work IQ: list_messages, forward, list_folders, move_message, copy_message, all attachment operations, folder management, calendar management, inbox rules, draft workflows, event instances, reminders, mail tips, get_writing_samples, draft_with_style_guide, and more.

Prerequisites

Azure AD app registration with these delegated permissions:

• Mail.ReadWrite - Read and write mail
• Mail.Send - Send mail
• Calendars.ReadWrite - Read and write calendars
• User.Read - Sign in and read profile
• User.ReadBasic.All - Read basic profiles
• MailboxSettings.ReadWrite - Manage inbox rules
• People.Read - List relevant people
• offline_access - Refresh tokens

Setup

1. Register an Azure AD application
2. Add the delegated permissions listed above
3. Generate a client secret
4. Grant admin consent for MailboxSettings.ReadWrite and People.Read
5. Update apiProperties.json with your client ID
6. Deploy with PAC CLI:

pac connector create `
  --api-definition-file apiDefinition.swagger.json `
  --api-properties-file apiProperties.json `
  --script-file script.csx

For Copilot Studio:

1. Open your agent
2. Go to Actions > Add an action > Connector
3. Search for your connector and add it
4. The agent discovers all 77 tools automatically

Application Insights

Add your connection string to script.csx to track:

• All incoming requests with operation IDs
• MCP tool invocations with timing
• Errors with full exception details

Resources

• GitHub repository
• Work IQ Mail reference
• Work IQ Calendar reference
• Graph Mail API documentation
• Graph Calendar API documentation