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](https://apps.apple.com/us/app/microsoft-outlook/id985367838) installed and configured
- [Bun](https://bun.sh/) installed
- [Claude desktop app](https://claude.ai/desktop) 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: ```bash bun add @modelcontextprotocol/sdk@^1.5.0 ```
- Check if the module exists in your node_modules directory: ```bash ls -la node_modules/@modelcontextprotocol/sdk/server/ ```
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