How do I install Outlook?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Outlook need an API key?

No required environment variable is listed on this record.

What transport does Outlook use?

Outlook runs locally over stdio.

When was Outlook last checked?

Last checked 2026-11-05. MCP server for Claude to access Outlook data via Microsoft Graph API

Outlook MCP 서버

에이전트 강화

이 서버 추가

Install from the publisher. Not a PlugMCP endpoint.

PlugMCP에서 실행

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

PlugMCP에서 실행

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

실행

Server facts

Local

Transport: stdio
Last checked: 2026-11-05

Stars: 447
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

M365 Assistant MCP Server

A comprehensive MCP (Model Context Protocol) server that connects Claude with Microsoft 365 services through the Microsoft Graph API and Power Automate API.

Supported Services

Outlook - Email, calendar, folders, and rules
OneDrive - Files, folders, search, and sharing
Power Automate - Flows, environments, and run history

Directory Structure

├── index.js                 # Main entry point
├── config.js                # Configuration settings
├── auth/                    # Authentication modules
│   ├── index.js             # Authentication exports
│   ├── token-manager.js     # Token storage and refresh (Graph + Flow)
│   └── tools.js             # Auth-related tools
├── calendar/                # Calendar functionality
│   ├── index.js             # Calendar exports
│   ├── list.js              # List events
│   ├── create.js            # Create event
│   ├── delete.js            # Delete event
│   ├── cancel.js            # Cancel event
│   ├── accept.js            # Accept event
│   └── decline.js           # Decline event
├── email/                   # Email functionality
│   ├── index.js             # Email exports
│   ├── list.js              # List emails
│   ├── search.js            # Search emails
│   ├── read.js              # Read email
│   ├── send.js              # Send email
│   └── mark-as-read.js      # Mark email read/unread
├── folder/                  # Folder functionality
│   ├── index.js             # Folder exports
│   ├── list.js              # List folders
│   ├── create.js            # Create folder
│   └── move.js              # Move emails
├── rules/                   # Email rules functionality
│   ├── index.js             # Rules exports
│   ├── list.js              # List rules
│   └── create.js            # Create rule
├── onedrive/                # OneDrive functionality
│   ├── index.js             # OneDrive exports
│   ├── list.js              # List files/folders
│   ├── search.js            # Search files
│   ├── download.js          # Get download URL
│   ├── upload.js            # Simple upload (<4MB)
│   ├── upload-large.js      # Chunked upload (>4MB)
│   ├── share.js             # Create sharing link
│   └── folder.js            # Create/delete folders
├── power-automate/          # Power Automate functionality
│   ├── index.js             # Power Automate exports
│   ├── flow-api.js          # Flow API client
│   ├── list-environments.js # List environments
│   ├── list-flows.js        # List flows
│   ├── run-flow.js          # Trigger flow
│   ├── list-runs.js         # Run history
│   └── toggle-flow.js       # Enable/disable flow
└── utils/                   # Utility functions
    ├── graph-api.js         # Microsoft Graph API helper
    ├── odata-helpers.js     # OData query building
    └── mock-data.js         # Test mode data

Features

Authentication: OAuth 2.0 authentication with Microsoft Graph API (+ Flow API for Power Automate)
Email Management: List, search, read, send, and organize emails
Calendar Management: List, create, accept, decline, and delete calendar events
OneDrive Integration: List, search, upload, download, and share files
Power Automate: List environments/flows, trigger flows, view run history
Modular Structure: Clean separation of concerns for maintainability
Test Mode: Simulated responses for testing without real API calls

Available Tools

Outlook (Email & Calendar)

Tool	Description
`list-emails`	List recent emails from inbox
`search-emails`	Search emails with filters
`read-email`	Read email content
`send-email`	Send a new email
`mark-as-read`	Mark email as read/unread
`list-events`	List calendar events
`create-event`	Create calendar event
`accept-event`	Accept event invitation
`decline-event`	Decline event invitation
`delete-event`	Delete calendar event
`list-folders`	List mail folders
`create-folder`	Create mail folder
`move-emails`	Move emails between folders
`list-rules`	List inbox rules
`create-rule`	Create inbox rule

OneDrive

Tool	Description
`onedrive-list`	List files in a path
`onedrive-search`	Search files by query
`onedrive-download`	Get download URL
`onedrive-upload`	Upload small file (<4MB)
`onedrive-upload-large`	Chunked upload (>4MB)
`onedrive-share`	Create sharing link
`onedrive-create-folder`	Create folder
`onedrive-delete`	Delete file or folder

Power Automate

Tool	Description
`flow-list-environments`	List Power Platform environments
`flow-list`	List flows in environment
`flow-run`	Trigger a manual flow
`flow-list-runs`	Get flow run history
`flow-toggle`	Enable/disable a flow

Quick Start

Install dependencies: npm install
Azure setup: Register app in Azure Portal (see detailed steps below)
Configure environment: Copy .env.example to .env and add your Azure credentials
Configure Claude: Update your Claude Desktop config with the server path
Start auth server: npm run auth-server
Authenticate: Use the authenticate tool in Claude to get the OAuth URL
Start using: Access your M365 data through Claude!

Installation

Prerequisites

Node.js 14.0.0 or higher
npm or yarn package manager
Azure account for app registration

Install Dependencies

npm install

Azure App Registration & Configuration

App Registration

Open Azure Portal
Search for "App registrations"
Click "New registration"
Name: "M365 MCP Server"
Account type: "Accounts in any organizational directory and personal Microsoft accounts"
Redirect URI: Web → http://localhost:3333/auth/callback
Click "Register"
Copy the "Application (client) ID" for your .env file

App Permissions

Go to "API permissions" under Manage
Click "Add a permission" → "Microsoft Graph" → "Delegated permissions"
Add these permissions:
- offline_access
- User.Read
- Mail.Read, Mail.ReadWrite, Mail.Send
- Calendars.Read, Calendars.ReadWrite
- Files.Read, Files.ReadWrite
Click "Add permissions"

For Power Automate (optional):

Requires additional Azure AD configuration with Flow API scope
See Power Automate section below for details

Client Secret

Go to "Certificates & secrets" → "Client secrets"
Click "New client secret"
Add description and select expiration
Copy the VALUE (not the Secret ID)

Configuration

1. Environment Variables

cp .env.example .env

Edit .env:

# Get these values from Azure Portal > App Registrations > Your App
MS_CLIENT_ID=your-application-client-id-here
MS_CLIENT_SECRET=your-client-secret-VALUE-here
MS_TENANT_ID=your-tenant-id-here
USE_TEST_MODE=false

Important Notes:

Use MS_CLIENT_ID and MS_CLIENT_SECRET in the .env file
Set MS_TENANT_ID for single-tenant apps to avoid /common endpoint errors
For Claude Desktop config, you'll use OUTLOOK_CLIENT_ID and OUTLOOK_CLIENT_SECRET
Always use the client secret VALUE, never the Secret ID

2. Claude Desktop Configuration

Add to your Claude Desktop config:

{
  "mcpServers": {
    "m365-assistant": {
      "command": "node",
      "args": ["/path/to/outlook-mcp/index.js"],
      "env": {
        "USE_TEST_MODE": "false",
        "OUTLOOK_CLIENT_ID": "your-client-id",
        "OUTLOOK_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Authentication

Graph API (Outlook + OneDrive)

Start auth server: npm run auth-server
Use the authenticate tool in Claude
Visit the provided URL and sign in
Tokens saved to ~/.outlook-mcp-tokens.json

Power Automate (Optional)

Power Automate requires a separate token with the Flow API scope. Configure additional Azure AD permissions for https://service.flow.microsoft.com//.default scope.

Limitations:

Only solution-aware flows are accessible
Only manual trigger flows can be run via API
Requires environment ID for most operations

Troubleshooting

Common Issues

"Cannot find module"

npm install

"Port 3333 in use"

npx kill-port 3333
npm run auth-server

"Invalid client secret" (AADSTS7000215)

Use the secret VALUE, not the Secret ID

"Authentication required"

Delete ~/.outlook-mcp-tokens.json and re-authenticate

Testing

# Run with MCP Inspector
npm run inspect

# Run in test mode (mock data)
npm run test-mode

# Run Jest tests
npm test

Extending the Server

Create new module directory
Implement tool handlers in separate files
Export tool definitions from module index
Import and add to TOOLS array in index.js

이 서버 추가

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Outlook?

Does Outlook need an API key?

What transport does Outlook use?

When was Outlook last checked?

Documentation

M365 Assistant MCP Server

Supported Services

Directory Structure

Features

Available Tools

Outlook (Email & Calendar)

OneDrive

Power Automate

Quick Start

Installation

Prerequisites

Install Dependencies

Azure App Registration & Configuration

App Registration

App Permissions

Client Secret

Configuration

1. Environment Variables

2. Claude Desktop Configuration

Authentication

Graph API (Outlook + OneDrive)

Power Automate (Optional)

Troubleshooting

Common Issues

Testing

Extending the Server