Outlook Meetings Scheduler MCP server for AI agents

The Outlook Meetings Scheduler MCP Server allows you to create and manage Microsoft Outlook calendar events using natural language commands through the Microsoft Graph API. It can find people's email addresses, create events with attendees, and integrates with other MCP servers for enhanced workflows.

Installation

Prerequisites

Before installing, you'll need to set up Microsoft Graph API access:

Register an application in the Microsoft Azure Portal
Create a client secret
Grant necessary permissions (Microsoft Graph API > Application permissions > Calendars.ReadWrite, People.Read.All, User.ReadBasic.All)
Note your Client ID, Client Secret, and Tenant ID

Installation Options

Using NPX (Simplest Method)

Add this configuration to your VS Code settings:

{
  "mcpServers": {
    "outlook-meetings-scheduler": {
      "command": "npx",
      "args": [
        "-y",
        "outlook-meetings-scheduler"
      ],
      "env": {
        "CLIENT_ID": "<YOUR_CLIENT_ID>",
        "CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "TENANT_ID": "<YOUR_TENANT_ID>",
        "USER_EMAIL": "<YOUR_EMAIL>"
      }
    }
  }
}

Using Local Node.js

Clone and build the project:

git clone https://github.com/anoopt/outlook-meetings-scheduler-mcp-server.git
cd outlook-meetings-scheduler-mcp-server
npm install
npm run build

Add to VS Code settings:

{
  "mcpServers": {
    "outlook-meetings-scheduler": {
      "command": "node",
      "args": [
        "/path/to/outlook-meetings-scheduler-mcp-server/build/index.js"
      ],
      "env": {
        "CLIENT_ID": "<YOUR_CLIENT_ID>",
        "CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "TENANT_ID": "<YOUR_TENANT_ID>",
        "USER_EMAIL": "<YOUR_EMAIL>"
      }
    }
  }
}

Using Docker

Build the Docker image:

docker build -t mcp/outlook-meetings-scheduler .

Add to VS Code settings:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "client_secret",
      "description": "Enter the client secret",
      "password": true
    }
  ],
  "servers": {
    "outlook-meetings-scheduler": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CLIENT_ID",
        "-e",
        "CLIENT_SECRET",
        "-e",
        "TENANT_ID",
        "-e",
        "USER_EMAIL",
        "mcp/outlook-meetings-scheduler"
      ],
      "env": {
        "USER_EMAIL": "<YOUR_EMAIL>",
        "CLIENT_ID": "<YOUR_CLIENT_ID>",
        "CLIENT_SECRET": "${input:client_secret}",
        "TENANT_ID": "<YOUR_TENANT_ID>"
      }
    }
  }
}

Claude Desktop Setup

For Claude Desktop, add similar configurations to your claude_desktop_config.json file.

Usage

Available Tools

The server provides the following tools:

1. Find Person

Finds a person's email address by their name
Example: I need to schedule a meeting with John Smith. Can you find his email address?

2. Create Event

Creates a basic calendar event
Example: Schedule a meeting titled "Weekly Team Sync" for next Monday at 10 AM

3. Create Event with Attendees

Creates a calendar event with specified attendees
Example: Create a meeting called "Project Kickoff" for tomorrow at 2 PM. Add Megan and John as required attendees.

4. Get Event

Retrieves details of a specific calendar event
Example: Show me the details of my meeting with Sarah tomorrow

5. List Events

Lists calendar events with optional filtering
Example: Show me all my meetings for next week

6. Delete Event

Deletes a calendar event
Example: Cancel my 3 PM meeting tomorrow

7. Update Event

Updates an existing calendar event
Example: Change my team meeting on Thursday to start at 2 PM instead of 1 PM

8. Update Event Attendees

Adds or removes attendees from a calendar event
Example: Add Mike to my project review meeting on Friday

Usage Examples

Simple Meeting Creation

Schedule a meeting titled "Budget Review" for next Tuesday at 3 PM.

Meeting with Attendees

Create a meeting called "Project Kickoff" for tomorrow at 2 PM. 
Add [email protected] and [email protected] as required attendees.
The agenda is:
1. Project overview
2. Timeline discussion
3. Role assignments
4. Next steps

Finding a Person's Email

I need to schedule a meeting with John Smith. Can you find his email address?

Integration with Other MCP Servers

You can combine this MCP server with others like the GitHub MCP server for enhanced workflows:

Example Multi-MCP Configuration

{
  "mcpServers": {
    "outlook-meetings-scheduler": {
      "command": "npx",
      "args": [
        "-y",
        "outlook-meetings-scheduler"
      ],
      "env": {
        "CLIENT_ID": "<YOUR_CLIENT_ID>",
        "CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "TENANT_ID": "<YOUR_TENANT_ID>",
        "USER_EMAIL": "<YOUR_EMAIL>"
      }
    },
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/github-mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}

Combined Workflow Example

Create an issue in the organization/repo repository titled "Fix pagination bug in user dashboard" with the description "Users report seeing duplicate entries when navigating between pages." Then schedule a calendar reminder for me to review this issue tomorrow at 3 PM.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "outlook-meetings-scheduler" '{"command":"npx","args":["-y","outlook-meetings-scheduler"],"env":{"CLIENT_ID":"<YOUR_CLIENT_ID>","CLIENT_SECRET":"<YOUR_CLIENT_SECRET>","TENANT_ID":"<YOUR_TENANT_ID>","USER_EMAIL":"<YOUR_EMAIL>"}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "outlook-meetings-scheduler": {
            "command": "npx",
            "args": [
                "-y",
                "outlook-meetings-scheduler"
            ],
            "env": {
                "CLIENT_ID": "<YOUR_CLIENT_ID>",
                "CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
                "TENANT_ID": "<YOUR_TENANT_ID>",
                "USER_EMAIL": "<YOUR_EMAIL>"
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "outlook-meetings-scheduler": {
            "command": "npx",
            "args": [
                "-y",
                "outlook-meetings-scheduler"
            ],
            "env": {
                "CLIENT_ID": "<YOUR_CLIENT_ID>",
                "CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
                "TENANT_ID": "<YOUR_TENANT_ID>",
                "USER_EMAIL": "<YOUR_EMAIL>"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect