# Outlook MCP (Model Context Protocol) Server

A Model Context Protocol server that integrates with Microsoft Outlook through Microsoft Graph API, allowing Claude and other LLMs to check calendar events, schedule new ones, read emails, and send messages.

## Features

- 📅 **Calendar Integration**: View, list, create, update, and delete calendar events
- 📧 **Email Integration**: Read, send, draft, and manage emails from your Outlook account
- 🔁 **Model Context Protocol**: Follows MCP standards for LLM tool integration
- 🛡️ **Type Safety**: Full TypeScript implementation with Zod validation

## Prerequisites

- Node.js 18+
- Microsoft 365 account with appropriate permissions
- Microsoft Azure App Registration with Graph API permissions (Calendar and Mail)

## Setup


1. Register an application in Azure Active Directory:
   - Go to [Azure Portal](https://portal.azure.com)
   - Navigate to "App registrations"
   - Create a new registration with a redirect URI of type "Public client/native (mobile & desktop)"
     - Register `http://localhost` as the redirect URI

   - Configure API permissions:
     - Choose Microsoft Graph and type delegated, as we will act on the users behalf
     - For Calendar: "Calendars.Read" and "Calendars.ReadWrite"
     - For Email: "Mail.Read", "Mail.ReadWrite" and "Mail.Send"
     - For People: "People.Read"

2. Note the values from your Azure app registration (Overview) to use for the MCP config as environment variables:
  - Client ID (Application (client) ID)
  - Authority ID (Directory (tenant) ID)

3. Register the MCP server
For Claude Desktop, create or update your configuration in `~/.claude/config.json`:

```json
{
  "mcpServers": {
    "outlook": {
      "command": "npx",
      "args": [
        "mcp_outlook"
      ],
      "env": {
        "AUTHORITY": "your-authority-id",
        "CLIENT_ID": "your-client-id",
        "MCP_SERVER_NAME": "outlook-mcp",
        "MCP_SERVER_VERSION": "1.0.0"
      }
    }
  }
}
```

Make sure to replace the path and environment variables with your actual values.

## Available Tools

### Calendar Tools
- **listCalendarEvents**: Lists the user's calendar events for a specified time range
- **createCalendarEvent**: Creates a new calendar event
- **getCalendarEvent**: Gets details of a specific calendar event
- **updateCalendarEvent**: Updates an existing calendar event
- **deleteCalendarEvent**: Deletes a calendar event

### Email Tools
- **listEmails**: Lists emails from a specified folder (inbox, sent, drafts, etc.)
- **getEmail**: Gets details of a specific email message
- **sendEmail**: Sends a new email message
- **createDraft**: Creates a draft email message without sending it
- **markEmailAsRead**: Marks an email message as read
- **markEmailAsUnread**: Marks an email message as unread
- **deleteEmail**: Deletes an email message

## People Tools
- **searchPeople** Find a person in the organisation or your recent contacts
- **getPerson** Get information on a person

### Resources
- **calendar**: Resource containing calendar events data
- **inbox**: Resource containing inbox messages data

## Development

Run in development mode with live reloading:
```
npm run dev
```

Run linting:
```
npm run lint
```

Configure your MCP locally
```json
{
  "mcpServers": {
    "outlook": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/outlook_mcp/build/index.js"
      ],
      "env": {
        "AUTHORITY": "your-authority-id",
        "CLIENT_ID": "your-client-id",
        "MCP_SERVER_NAME": "outlook-mcp",
        "MCP_SERVER_VERSION": "1.0.0"
      }
    }
  }
}
```