Outlook_Calendar_MCP
A Model Context Protocol (MCP) server that allows Claude to access and manage your local Microsfot Outlook calendar (Windows only).
claude mcp add --transport stdio merajmehrabi-outlook_calendar_mcp outlook-calendar-mcp
How to use
The Outlook Calendar MCP Tool exposes your local Microsoft Outlook calendar via the Model Context Protocol (MCP) so Claude can query, manage, and schedule around your calendar without exposing data to external services. It supports listing events within a date range, creating and updating events (including meetings with attendees), finding free time slots, and checking attendee responses. It also supports working with multiple calendars in your Outlook profile. Once configured in Claude, you can issue natural language prompts like asking for next week’s meetings, creating a new event with attendees, or finding a one-hour slot that works for everyone.
Tools available include:
- List Calendar Events: fetch events within a date range and view details.
- Create Calendar Event: add new events or meetings with optional attendees and calendar selection.
- Find Free Time Slots: identify open times given a duration and optional workday bounds.
- Get Attendee Status: check responses for a specific event.
- Update Calendar Event and Get Calendars: modify existing events and query which calendars exist. The server runs locally on Windows with Outlook, using VBScript integration as needed for access to the local Outlook client.
How to install
Prerequisites:
- Windows operating system with Microsoft Outlook desktop client installed
- Node.js (version 14.x or higher) and npm
- VBScript support (on Windows 11 24H2+ you may need to enable/install VBScript)
Option A: Install from npm (global)
- Install the MCP tool globally:
npm install -g outlook-calendar-mcp
- Run the server directly:
outlook-calendar-mcp
Option B: Use npx (without installation)
- Run via npx:
npx outlook-calendar-mcp
Option C: Install from source
- Clone the repository or download the source code
- Install dependencies:
npm install
- Start the server:
npm start
Note: If you encounter VBScript issues on Windows 11 24H2+, follow the VBScript installation steps described in the README to enable optional VBScript features.
Additional notes
Tips and caveats:
- The MCP server communicates only with your local Outlook client; no calendar data is sent to external servers by the tool.
- On first use, Outlook prompts may appear to allow script access; ensure you grant the necessary permissions.
- If you modify the path when configuring the MCP in Claude, ensure the node path points to the actual entry file (for source installations).
- For Windows 11 24H2+ users, VBScript may require enabling as an optional feature; see the VBScript Installation section in the README for steps.
- If you see script execution or path-related errors, verify that the command and path in your MCP configuration match how you installed or started the server (npm global vs npx vs local source).
- When using update_event or delete_event, you’ll need the event ID from list_events results (the Outlook EntryID.