Outlook Tools
A Model Context Protocol server that enables AI assistants to interact with Microsoft Outlook for calendar management, email operations, and search functionality.
What is Outlook Tools?
Outlook Tools is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that enables ai assistants to interact with microsoft outlook for calendar management, email operations, and search functionality.
A Model Context Protocol server that enables AI assistants to interact with Microsoft Outlook for calendar management, email operations, and search functionality.
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol server that enables AI assistants t
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-outlook-toolsConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Outlook Tools
MCP Outlook Tools is a Model Context Protocol server that gives AI assistants direct control over Microsoft Outlook on Windows. It exposes tools for creating calendar appointments, retrieving calendar events by date range, sending emails with CC support, and searching emails by date and keyword—including Japanese text encoding support. Requires Windows with Outlook installed.
Prerequisites
- Windows operating system with Microsoft Outlook installed and configured with an active account
- Python 3.10 or later
- uv package manager (https://docs.astral.sh/uv/)
- Git to clone the repository
- Claude Desktop or another MCP-compatible client
Clone the repository
Clone the mcp-outlook-tools repository to your local machine.
git clone https://github.com/wmoto-ai/mcp-outlook-tools.git
cd mcp-outlook-toolsInstall the package
Install the package and its dependencies using uv or pip.
# Using uv (recommended)
uv pip install -e .
# Using pip
pip install -e .Add to Claude Desktop configuration
Edit claude_desktop_config.json to register the server. The PYTHONIOENCODING environment variable is required for correct handling of non-ASCII characters in email subjects and bodies.
{
"mcpServers": {
"outlook-tools": {
"command": "uv",
"args": [
"--directory", "C:\\Users\\yourname\\mcp-outlook-tools",
"run", "--with-editable", ".",
"python", "-m", "mcp_outlook_tools"
],
"cwd": "C:\\Users\\yourname\\mcp-outlook-tools",
"env": {
"PYTHONIOENCODING": "utf-8"
}
}
}
}Restart Claude Desktop
Fully quit and reopen Claude Desktop so it picks up the new MCP server configuration. Outlook must be running or at least configured in the Windows profile.
# Close and reopen Claude Desktop
# Then verify by asking:
"What Outlook tools are available?"Run development checks (optional)
If contributing or troubleshooting, run the test suite, type checker, and linter.
pytest test/
pyright src/
ruff check src/Outlook Tools Examples
Client configuration
Claude Desktop claude_desktop_config.json for MCP Outlook Tools on Windows using uv.
{
"mcpServers": {
"outlook-tools": {
"command": "uv",
"args": [
"--directory", "C:\\Projects\\mcp-outlook-tools",
"run", "--with-editable", ".",
"python", "-m", "mcp_outlook_tools"
],
"cwd": "C:\\Projects\\mcp-outlook-tools",
"env": {
"PYTHONIOENCODING": "utf-8"
}
}
}
}Prompts to try
Example prompts using the calendar, email, and search tools.
- "Add a meeting called 'Sprint Planning' tomorrow from 10am to 11am in Conference Room B"
- "Show me all my calendar events for next week"
- "Send an email to [email protected] about the project status update"
- "Search my emails from last month that mention 'budget'"
- "Create an out-of-office appointment for December 25th marked as Out of Office"Troubleshooting Outlook Tools
Server fails to start or COM automation errors appear
MCP Outlook Tools uses Windows COM automation to control Outlook. Ensure Microsoft Outlook is installed via MSI (not just the Microsoft Store app) and is properly configured with at least one email account. Run the script once manually from a terminal to see the raw COM error message.
Email subjects or body text with special characters appear garbled
Confirm PYTHONIOENCODING is set to utf-8 in the env block of your MCP configuration. This is especially important for Japanese, Chinese, or other multibyte character sets.
Calendar events are created with wrong time zone
The server uses the system locale and Outlook's configured time zone. Ensure your Windows system clock and Outlook calendar time zone settings match the intended time zone before creating appointments.
Frequently Asked Questions about Outlook Tools
What is Outlook Tools?
Outlook Tools is a Model Context Protocol (MCP) server that model context protocol server that enables ai assistants to interact with microsoft outlook for calendar management, email operations, and search functionality. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Outlook Tools?
Follow the installation instructions on the Outlook Tools GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Outlook Tools?
Outlook Tools works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Outlook Tools free to use?
Yes, Outlook Tools is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Outlook Tools Alternatives — Similar Communication Servers
Looking for alternatives to Outlook Tools? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Outlook Tools in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Outlook Tools?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.