Outlook Calendar MCP
local-only server
The server can only run on the client’s local machine because it depends on local resources.
Outlook Calendar MCP Tool
A Model Context Protocol (MCP) server that allows Claude to access and manage your local Microsfot Outlook calendar (Windows only).
Features
- View Calendar Events: List events within a date range, view event details, check attendee status
- Manage Calendar Events: Create new events and meetings, update existing events
- Calendar Intelligence: Find free time slots for scheduling, identify optimal meeting times
- Multiple Calendar Support: Access different calendars in your Outlook profile
Prerequisites
- Windows operating system
- Microsoft Outlook desktop client installed
- Node.js (version 14.x or higher)
- npm (comes with Node.js)
Installation
Option 1: Install from npm
You can also run it directly without installation using npx:
Option 2: Install from source
- Clone this repository or download the source code
- Install dependencies:
- Run the server:
MCP Server Configuration
To use this tool with Claude, you need to add it to your MCP settings configuration file.
For Claude Desktop App
Add the following to your Claude Desktop configuration file (located at %APPDATA%\Claude\claude_desktop_config.json
):
If installed globally via npm:
Using npx (without installation):
If installed from source:
For Claude VSCode Extension
Add the following to your Claude VSCode extension MCP settings file (located at %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
):
If installed globally via npm:
Using npx (without installation):
If installed from source:
For source installation, replace path/to/outlook-calendar-mcp
with the actual path to where you installed this tool.
Usage
Once configured, Claude will have access to the following tools:
List Calendar Events
Example: "List my calendar events for next week"
Create Calendar Event
Example: "Add a meeting with John about the project proposal on Friday at 2 PM"
Find Free Time Slots
Example: "When am I free for a 1-hour meeting this week?"
Get Attendee Status
Example: "Who hasn't responded to my team meeting invitation?"
Important Note: When using operations that require an event ID (update_event, delete_event, get_attendee_status), you must use the
id
field from the list_events response. This is the unique EntryID that Outlook uses to identify events.
Update Calendar Event
Example: "Update my team meeting tomorrow to start at 3 PM instead of 2 PM"
Get Calendars
Example: "Show me my available calendars"
Security Notes
- On first use, Outlook may display security prompts to allow script access
- The tool only accesses your local Outlook client and does not send calendar data to external servers
- All calendar operations are performed locally on your computer
Troubleshooting
- Outlook Security Prompts: If you see security prompts from Outlook, you need to allow the script to access your Outlook data
- Script Execution Policy: If you encounter script execution errors, you may need to adjust your PowerShell execution policy
- Path Issues: Ensure the path in your MCP configuration file points to the correct location of the tool
Contributing
We welcome contributions to the Outlook Calendar MCP Tool! Please see our Contributing Guide for details on how to get started.
By participating in this project, you agree to abide by our Code of Conduct.
License
This project is licensed under the MIT License - see the LICENSE file for details.
You must be authenticated.
The Outlook Calendar MCP enables Claude to directly manage Microsoft Outlook calendars on Windows systems, offering a privacy-focused solution that keeps all data local. Users can view events, create meetings, find free time slots, and manage multiple calendars without their data leaving their machi
- Features
- Prerequisites
- Installation
- MCP Server Configuration
- Usage
- Security Notes
- Troubleshooting
- Contributing
- License