Claude Outlook MCP Tool

This is a Model Context Protocol (MCP) tool that allows Claude to interact with Microsoft Outlook for macOS.

Features

Mail:
- Read unread and regular emails
- Search emails by keywords
- Send emails with to, cc, and bcc recipients
- Send HTML-formatted emails
- Attach files to emails
- List mail folders
Calendar:
- View today's events
- View upcoming events
- Search for events
- Create new calendar events
Contacts:
- List contacts
- Search contacts by name

Prerequisites

macOS with Apple Silicon (M1/M2/M3) or Intel chip
Microsoft Outlook for Mac installed and configured
Bun installed
Claude desktop app installed

Installation

Clone this repository:

git clone https://github.com/syedazharmbnr1/claude-outlook-mcp.git
cd claude-outlook-mcp

Install dependencies:

bun install

Make sure the script is executable:

chmod +x index.ts

Update your Claude Desktop configuration:

Edit your claude_desktop_config.json file (located at ~/Library/Application Support/Claude/claude_desktop_config.json) to include this tool:

{
  "mcpServers": {
    "outlook-mcp": {
      "command": "/Users/YOURUSERNAME/.bun/bin/bun",
      "args": ["run", "/path/to/claude-outlook-mcp/index.ts"]
    }
  }
}

Make sure to replace YOURUSERNAME with your actual macOS username and adjust the path to where you cloned this repository.

Restart Claude Desktop app
Grant permissions:
- Go to System Preferences > Privacy & Security > Privacy
- Give Terminal (or your preferred terminal app) access to Accessibility features
- You may see permission prompts when the tool is first used

Usage

Once installed, you can use the Outlook tool directly from Claude by asking questions like:

"Can you check my unread emails in Outlook?"
"Search my Outlook emails for the quarterly report"
"Send an email to john@example.com with the subject 'Meeting Tomorrow'"
"What's on my calendar today?"
"Create a meeting for tomorrow at 2pm"
"Find the contact information for Jane Smith"

Examples

Email Operations

Check my unread emails in Outlook

Send an email to alex@example.com with subject "Project Update" and the following body: Here's the latest update on our project. We've completed phase 1 and are moving on to phase 2.

Send an HTML email to team@example.com with subject "Weekly Report" and attach the quarterly_results.pdf file

Search my emails for "budget meeting"

Calendar Operations

What events do I have today?

Create a calendar event for a team meeting tomorrow from 2pm to 3pm

Show me my upcoming events for the next 2 weeks

Contact Operations

List all my Outlook contacts

Search for contact information for Jane Smith

Advanced Features

HTML Email Support

You can send rich HTML-formatted emails by setting the isHtml parameter to true:

Send an HTML email to john@example.com with the subject "Project Update" and body "<h1>Project Update</h1><p>We've made <b>significant progress</b> on the project.</p>"

File Attachments

You can attach files to your emails by providing the file paths in the attachments parameter:

Send an email to jane@example.com with subject "Monthly Report" and attach the reports/march_2025.pdf file

For best results with attachments:

Use absolute file paths when possible
Make sure the files are accessible to the process running the MCP tool
Attachments will automatically be handled with robust error detection

Troubleshooting

If you encounter issues with attachments:

Check if the file exists and is readable
Use absolute file paths instead of relative paths
Make sure the user running the process has permission to read the file

If you encounter the error Cannot find module '@modelcontextprotocol/sdk/server/index.js':

Make sure you've run bun install to install all dependencies
Try installing the MCP SDK explicitly:
bun add @modelcontextprotocol/sdk@^1.5.0
Check if the module exists in your node_modules directory:
ls -la node_modules/@modelcontextprotocol/sdk/server/

If the error persists, try creating a new project with Bun:

mkdir -p ~/yourpath/claude-outlook-mcp
cd ~/yourpath/claude-outlook-mcp
bun init -y

Then copy the package.json and index.ts files to the new directory and run:

bun install
bun run index.ts

Update your claude_desktop_config.json to point to the new location.

License

MIT

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

A Model Context Protocol tool that enables Claude to interact with Microsoft Outlook for macOS, allowing users to read/send emails, manage calendar events, and access contacts through natural language commands.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Hello-MCP
hongsw
-
security
A
license
-
quality
A utility tool that enables Claude Desktop to interact with external tools via the Model Context Protocol, providing features like email sending and simple calculations while simplifying the MCP setup process.
Last updated -
129
9
JavaScript
MIT License
ClaudePost
ZilongXue
-
security
A
license
-
quality
A Model Context Protocol server that provides a seamless email management interface through Claude, allowing users to search, read, and send emails directly through natural language conversations.
Last updated -
40
Python
MIT License
Dynamics 365 MCP Server
srikanth-paladugula
A
security
A
license
A
quality
A Model Context Protocol server that enables interaction with Microsoft Dynamics 365 CRM from Claude Desktop, allowing users to retrieve, create, and update CRM data through natural language.
Last updated -
5
4
TypeScript
MIT License
Dynamics 365 MCP Server
srikanth-paladugula
A
security
A
license
A
quality
A Model Context Protocol server that enables Claude Desktop to interact with Microsoft Dynamics 365, allowing users to retrieve information, create and update accounts, and manage opportunities through natural language.
Last updated -
5
4
TypeScript
MIT License

View all related MCP servers

Claude Outlook MCP Tool