Outlook Calendar MCP Server

What is Outlook Calendar MCP Server?

Outlook Calendar MCP Server is a Model Context Protocol server that provides read-only access to your Outlook/Microsoft 365 calendar. It is built with Go and designed for use with AI assistants that need to query calendar data.

How to use Outlook Calendar MCP Server?

Build the server binary with go build -o outlook-mcp ./cmd/mcp, then run it with optional config file and .env file arguments. First call the get_auth_url tool to authenticate via browser, then use get_calendar_events to retrieve events for a date range.

Key features of Outlook Calendar MCP Server

• Read-only access to Microsoft 365 calendar data
• On-demand authentication with Microsoft via OAuth
• Configurable via YAML file or environment variables
• Cross-platform binaries for Windows, macOS, and Linux
• CLI client included for testing and interactive use

Use cases of Outlook Calendar MCP Server

• AI assistants retrieving your upcoming meetings and events
• Automating calendar summaries for a given date range
• Integrating calendar queries into MCP-compatible tools

FAQ from Outlook Calendar MCP Server

How do I authenticate with Outlook Calendar MCP Server?

Call the get_auth_url tool to receive an authentication URL, open it in your browser to authorize the application, and the server captures the callback and stores the token.

What configuration is required?

You need a registered Azure AD application with Calendars.Read, Calendars.Read.Shared, and Calendars.ReadBasic permissions, plus a redirect URI of http://localhost:1111/callback. Provide tenant ID, client ID, and client secret via environment variables or a .env file.

Does the server support write operations?

No. The server only provides read-only access to calendar data; no write operations are implemented.

Where is the authentication token stored?

The token is stored in memory only for the duration of the server's execution. It is not persisted to disk.

What are the runtime requirements?

Go 1.21 or higher to build from source, and a Microsoft 365 account with calendar access. Pre-built binaries require no Go runtime.