Outlook Calendar MCP
The Outlook Calendar MCP server allows Claude to interact with and manage your local Microsoft Outlook calendar on Windows. With this server, you can:
View calendar events within a specified date range
Create new events or meetings with details like attendees, location, and description
Find free time slots for scheduling meetings
Check the response status of meeting attendees
Update existing calendar events
Delete calendar events
Access and manage multiple calendars within your Outlook profile
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Outlook Calendar MCP show me my meetings for tomorrow"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Outlook Calendar MCP Tool
A Model Context Protocol (MCP) server that allows Claude to access and manage your local Microsoft 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
Related MCP server: Enhanced Outlook MCP Server
Prerequisites
Windows operating system
Microsoft Outlook desktop client installed
VBScript support (see VBScript Installation below if you're on Windows 11 24H2+)
Node.js (version 14.x or higher)
npm (comes with Node.js)
VBScript Installation (Windows 11 24H2+ Users)
Important: Starting with Windows 11 24H2, VBScript is no longer installed by default and must be enabled as an optional feature.
If you're experiencing issues with the MCP server not working after a Windows update, you likely need to install VBScript:
Open Settings (Windows + I)
Go to Apps → Optional features
Click "View features" next to "Add an optional feature"
Search for "VBScript"
Select VBScript and click Install
Restart your computer after installation
VBScript Deprecation Timeline:
Phase 1 (Late 2024+): Available as optional feature in Windows 11 24H2
Phase 2 (~2027): Will no longer be enabled by default
Phase 3 (Future): Complete removal from Windows
Note: Thanks to community feedback about VBScript deprecation, I'm considering architectural improvements to make the project more future-proof.
Installation
Option 1: Install from npm
npm install -g outlook-calendar-mcpYou can also run it directly without installation using npx:
npx outlook-calendar-mcpOption 2: Install from source
Clone this repository or download the source code
Install dependencies:
npm installRun the server:
npm startMCP 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:
{
"mcpServers": {
"outlook-calendar": {
"command": "outlook-calendar-mcp",
"args": [],
"env": {}
}
}
}Using npx (without installation):
{
"mcpServers": {
"outlook-calendar": {
"command": "npx",
"args": ["-y", "outlook-calendar-mcp"],
"env": {}
}
}
}If installed from source:
{
"mcpServers": {
"outlook-calendar": {
"command": "node",
"args": ["path/to/outlook-calendar-mcp/src/index.js"],
"env": {}
}
}
}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:
{
"mcpServers": {
"outlook-calendar": {
"command": "outlook-calendar-mcp",
"args": [],
"env": {}
}
}
}Using npx (without installation):
{
"mcpServers": {
"outlook-calendar": {
"command": "npx",
"args": ["-y", "outlook-calendar-mcp"],
"env": {}
}
}
}If installed from source:
{
"mcpServers": {
"outlook-calendar": {
"command": "node",
"args": ["path/to/outlook-calendar-mcp/src/index.js"],
"env": {}
}
}
}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
list_events
- startDate: Start date in MM/DD/YYYY format
- endDate: End date in MM/DD/YYYY format (optional)
- calendar: Calendar name (optional)Example: "List my calendar events for next week"
Create Calendar Event
create_event
- subject: Event subject/title
- startDate: Start date in MM/DD/YYYY format
- startTime: Start time in HH:MM AM/PM format
- endDate: End date in MM/DD/YYYY format (optional)
- endTime: End time in HH:MM AM/PM format (optional)
- location: Event location (optional)
- body: Event description (optional)
- isMeeting: Whether this is a meeting with attendees (optional)
- attendees: Semicolon-separated list of attendee email addresses (optional)
- calendar: Calendar name (optional)Example: "Add a meeting with John about the project proposal on Friday at 2 PM"
Find Free Time Slots
find_free_slots
- startDate: Start date in MM/DD/YYYY format
- endDate: End date in MM/DD/YYYY format (optional)
- duration: Duration in minutes (optional)
- workDayStart: Work day start hour (0-23) (optional)
- workDayEnd: Work day end hour (0-23) (optional)
- calendar: Calendar name (optional)Example: "When am I free for a 1-hour meeting this week?"
Get Attendee Status
get_attendee_status
- eventId: Event ID
- calendar: Calendar name (optional)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
idfield from the list_events response. This is the unique EntryID that Outlook uses to identify events.
Update Calendar Event
update_event
- eventId: Event ID to update
- subject: New event subject/title (optional)
- startDate: New start date in MM/DD/YYYY format (optional)
- startTime: New start time in HH:MM AM/PM format (optional)
- endDate: New end date in MM/DD/YYYY format (optional)
- endTime: New end time in HH:MM AM/PM format (optional)
- location: New event location (optional)
- body: New event description (optional)
- calendar: Calendar name (optional)Example: "Update my team meeting tomorrow to start at 3 PM instead of 2 PM"
Get Calendars
get_calendarsExample: "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
VBScript Not Available (Windows 11 24H2+): If you get errors after a Windows update, VBScript may need to be installed. See VBScript Installation section above
"Script execution failed" errors: Usually indicates VBScript is not available or Outlook is not accessible
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.
Available Tools
7 toolscreate_eventC
Create a new calendar event or meeting
Inputs: startDate (required), startTime (required), subject (required), attendees, +6 more.
delete_eventB
Delete a calendar event by its ID
Inputs: eventId (required), calendar.
find_free_slotsC
Find available time slots in the calendar
Inputs: startDate (required), calendar, duration, endDate, +2 more.
get_attendee_statusC
Check the response status of meeting attendees
Inputs: eventId (required), calendar.
get_calendarsB
List available calendars
Inputs: no named parameters.
list_eventsC
List calendar events within a specified date range
Inputs: startDate (required), calendar, endDate.
update_eventC
Update an existing calendar event
Inputs: eventId (required), body, calendar, endDate, +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Every tool has a clearly distinct purpose with no overlap: create, delete, list, and update events are separate operations, while find_free_slots, get_attendee_status, and get_calendars target unique aspects of calendar management. An agent can easily distinguish between them without confusion.
All tools follow a consistent verb_noun pattern using snake_case (e.g., create_event, list_events, get_calendars). The naming is predictable and readable throughout, with no deviations in style or convention.
With 7 tools, this server is well-scoped for managing an Outlook calendar. Each tool earns its place by covering essential operations like event CRUD, calendar listing, attendee tracking, and scheduling assistance, avoiding bloat or thin coverage.
The tool set provides complete CRUD/lifecycle coverage for calendar events (create, list, update, delete) and extends to key domain functions like finding free slots, checking attendee status, and listing calendars. There are no obvious gaps that would hinder agent workflows.
Maintenance
Related MCP Connectors
Read and change Google Calendar and Outlook events, find free time and add meeting links.
AI-native scheduling: check availability, book meetings, cancel and reschedule via MCP
Manage Google, Outlook & Apple calendars and create private sync rules from chat.
EU-hosted calendar MCP: Google, Outlook, iCloud, GMX, WEB.DE, CalDAV. Read, book, RSVP, sync.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA 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.105 npm48MIT
- AlicenseNot gradedqualityDmaintenanceConnects Claude with Microsoft Outlook through the Graph API, providing comprehensive email, calendar, folder management, and rules creation capabilities.19MIT
- AlicenseNot gradedqualityDmaintenanceConnects Claude to Microsoft Outlook through the Microsoft Graph API, enabling email management (list, search, read, send) and calendar operations (list, create, accept, decline, delete events) via OAuth 2.0 authentication.1MIT
- AlicenseBqualityDmaintenanceEnables creating, modifying, and checking Google Calendar events from Claude desktop app using MCP protocol with secure OAuth2 authentication.22MIT