Outlookmcp

An MCP server that provides read - only access to Outlook/Microsoft 365 calendars, supporting querying calendar events through APIs or command - line tools.

Schedule management Developer tools #Calendar Query #Microsoft 365 #Read - Only API #Authentication .Go

rating : 2.5 points

downloads : 17

update time : 2025-04-29

What is the Outlook Calendar MCP Server?

The Outlook Calendar MCP Server is a tool that provides read-only access, allowing your AI assistant to view your activities in the Outlook or Microsoft 365 calendar.

How to use the Outlook Calendar MCP Server?

First, you need to complete the authentication process, and then you can request a list of calendar events for a specific time period.

Applicable Scenarios

This service is suitable for users who want to integrate calendar functions into their AI applications, such as itinerary scheduling and meeting reminders.

Main Features

Dynamic AuthenticationWhen called for the first time, the system will check if authentication has been completed; if not, it will return an authorization URL that needs to be manually completed.

Get Calendar EventsGet a detailed list of calendar events, including information such as time, location, and participants, based on the specified time range.

Advantages and Limitations

Advantages

Read-only access ensures data security.

Easy to use without complex configuration.

Supports cross - platform operation, including Windows, macOS, and Linux.

Limitations

Limited to read functions and cannot modify calendar content.

Requires a Microsoft 365 account and an Azure AD registered application.

Has a certain dependence on the network environment.

How to Use

Step 1: Installation and Configuration

Download and install the required dependency packages, and create a configuration file and an environment variable file.

Step 2: Start the Server

Run the server to start listening for requests.

Step 3: Send a Request

Call the API to get calendar event data.

Usage Examples

Example 1: Get the Authorization URLStart the authentication process and open the browser to enter the provided URL.

Example 2: Get Calendar EventsQuery calendar events from the past week.

Frequently Asked Questions

How to start using this service?

Why doesn't my request return any results?

Does it support custom calendar views?

Related Resources

Official Documentation

Learn more about the features of Azure Active Directory.

GitHub Repository

Get the source code and participate in development.

Video Tutorial

Watch the quick - start guide.

🚀 Outlook Calendar MCP Server

This is an MCP (Model Context Protocol) server that provides read-only access to your Outlook/Microsoft 365 calendar.

🚀 Quick Start

✨ Features

Offers read-only access to Outlook/Microsoft 365 calendars.
Supports multiple build options for different platforms.
Allows configuration through YAML files or environment variables.

📦 Installation

git clone https://github.com/your-username/outlookmcp.git
cd outlookmcp
go mod download

💻 Usage Examples

Building the MCP Server

# Build for the current platform
go build -o outlook-mcp ./cmd/mcp

# Cross-compile for Windows
GOOS=windows GOARCH=amd64 go build -o outlook-mcp.exe ./cmd/mcp

# Cross-compile for macOS
GOOS=darwin GOARCH=amd64 go build -o outlook-mcp-mac ./cmd/mcp

# Cross-compile for Linux
GOOS=linux GOARCH=amd64 go build -o outlook-mcp-linux ./cmd/mcp

Building the CLI Client

# Build for the current platform
go build -o outlook-cli ./cmd/cli

# Cross-compile for Windows
GOOS=windows GOARCH=amd64 go build -o outlook-cli.exe ./cmd/cli

# Cross-compile for macOS
GOOS=darwin GOARCH=amd64 go build -o outlook-cli-mac ./cmd/cli

# Cross-compile for Linux
GOOS=linux GOARCH=amd64 go build -o outlook-cli-linux ./cmd/cli

📚 Documentation

Prerequisites

Go 1.21 or higher.
A Microsoft 365 account with calendar access.
An application registered in Azure AD with appropriate permissions.

Project Structure

outlook/outlook_api.go - Internal API for interacting with the Outlook calendar.
cmd/mcp/main.go - MCP server implementation for AI assistants.
cmd/cli/main.go - Command-line interface for testing.
config.example.yaml - Example configuration file.

Configuration

There are two ways to configure the server:

Use a YAML configuration file (refer to config.example.yaml).
Use environment variables.

Configuration File

Create a config.yaml file based on the example:

outlook:
  me: "John Doe"
  max_attendees: 10
  max_event_count: 50
  skip_all_day_events: true

Environment Variables

Create a .env file containing your Azure AD application credentials:

OUTLOOK_TENANT_ID=your-tenant-id
OUTLOOK_CLIENT_ID=your-client-id
OUTLOOK_CLIENT_SECRET=your-client-secret

🔧 Technical Details

The server is implemented in Go and interacts with the Outlook calendar API to provide read-only access to calendar data. It uses the MCP protocol to communicate with AI assistants.

📄 License

No license information provided in the original document.

⚠️ Important Note

Store client secrets securely (use environment variables).

The server only provides read-only access to calendar data.

Write operations are not implemented.

Tokens are only stored in memory during server execution.