Integrations
Used as the JavaScript runtime to execute the MCP server code.
Required as the operating system environment for running the MCP tool with macOS-specific Outlook integration.
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:
- Install dependencies:
- Make sure the script is executable:
- 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:
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
Calendar Operations
Contact Operations
Advanced Features
HTML Email Support
You can send rich HTML-formatted emails by setting the isHtml
parameter to true:
File Attachments
You can attach files to your emails by providing the file paths in the attachments
parameter:
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:Copy
- Check if the module exists in your node_modules directory:Copy
If the error persists, try creating a new project with Bun:
Then copy the package.json and index.ts files to the new directory and run:
Update your claude_desktop_config.json to point to the new location.
License
MIT
You must be authenticated.
local-only server
The server can only run on the client's local machine because it depends on local resources.
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
Related MCP Servers
- -securityAlicense-qualityA 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 -1299JavaScriptMIT License
- -securityAlicense-qualityA 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 -40PythonMIT License
- AsecurityAlicenseAqualityA 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 -54TypeScriptMIT License
- AsecurityAlicenseAqualityA 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 -54TypeScriptMIT License