Main entry point

Skip to content

You signed in with another tab or window. Reload
to refresh your session. You signed out in another tab or window. Reload
to refresh your session. You switched accounts on another tab or window. Reload
to refresh your session. Dismiss alert

ryaker / outlook-mcp Public

• Notifications
  You must be signed in to change notification settings

• Fork 3

• Star 9

MCP server for Claude to access Outlook data via Microsoft Graph API

9 stars
3 forks
Branches
Tags
Activity

Star

Notifications
You must be signed in to change notification settings

ryaker/outlook-mcp

main

1 Branch
0 Tags

Go to file

Code

Folders and files

| Name | | Name | Last commit message | Last commit date |
| --- | --- | --- | --- |
| Latest commit
-------------



Example User

Add rule sequencing, folder ID detection, and GitHub organization scr…

Mar 13, 2025

bbccdd8
 · Mar 13, 2025

History
-------

3 Commits

| | |
| auth | | auth | Initial commit | Mar 13, 2025 |
| email | | email | Initial commit | Mar 13, 2025 |
| folder | | folder | Initial commit | Mar 13, 2025 |
| rules | | rules | Add rule sequencing, folder ID detection, and GitHub organization scr… | Mar 13, 2025 |
| utils | | utils | Initial commit | Mar 13, 2025 |
| .gitignore | | .gitignore | Initial commit | Mar 13, 2025 |
| README.md | | README.md | Initial commit | Mar 13, 2025 |
| backup-logs.sh | | backup-logs.sh | Initial commit | Mar 13, 2025 |
| claude-config-sample.json | | claude-config-sample.json | Initial commit | Mar 13, 2025 |
| config.js | | config.js | Initial commit | Mar 13, 2025 |
| create-notifications-rule.js | | create-notifications-rule.js | Added files for subfolders | Mar 13, 2025 |
| find-folder-ids.js | | find-folder-ids.js | Added files for subfolders | Mar 13, 2025 |
| index.js | | index.js | Initial commit | Mar 13, 2025 |
| move-github-emails.js | | move-github-emails.js | Added files for subfolders | Mar 13, 2025 |
| outlook-auth-server.js | | outlook-auth-server.js | Initial commit | Mar 13, 2025 |
| package.json | | package.json | Initial commit | Mar 13, 2025 |
| test-direct.sh | | test-direct.sh | Initial commit | Mar 13, 2025 |
| test-modular-server.sh | | test-modular-server.sh | Initial commit | Mar 13, 2025 |
| View all files | | |

Repository files navigation

Modular Outlook MCP Server

This is a modular implementation of the Outlook MCP (Model Context Protocol) server that connects Claude with Microsoft Outlook through the Microsoft Graph API.

Directory Structure

/modular/
├── index.js                 # Main entry point
├── config.js                # Configuration settings
├── auth/                    # Authentication modules
│   ├── index.js             # Authentication exports
│   ├── token-manager.js     # Token storage and refresh
│   └── tools.js             # Auth-related tools
├── email/                   # Email functionality
│   ├── index.js             # Email exports
│   ├── list.js              # List emails
│   ├── search.js            # Search emails
│   ├── read.js              # Read email
│   └── send.js              # Send email
└── 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
• Email Management: List, search, read, and send emails
• Modular Structure: Clean separation of concerns for better maintainability
• OData Filter Handling: Proper escaping and formatting of OData queries
• Test Mode: Simulated responses for testing without real API calls

Configuration

To configure the server, edit the config.js file to change:

• Server name and version
• Test mode settings
• Authentication parameters
• Email field selections
• API endpoints

Usage with Claude Desktop

1. Copy the sample configuration from claude-config-sample.json to your Claude Desktop configuration
2. Restart Claude Desktop
3. Authenticate with Microsoft using the authenticate tool
4. Use the email tools to manage your Outlook account

Running Standalone

You can test the server using:

./test-modular-server.sh

This will use the MCP Inspector to directly connect to the server and let you test the available tools.

Authentication Flow

1. Start a local authentication server on port 3333 (using outlook-auth-server.js)
2. Use the authenticate tool to get an authentication URL
3. Complete the authentication in your browser
4. Tokens are stored in ~/.outlook-mcp-tokens.json

Troubleshooting

• Authentication Issues: Check the token file and authentication server logs
• OData Filter Errors: Look for escape sequences in the server logs
• API Call Failures: Check for detailed error messages in the response

Extending the Server

To add more functionality:

1. Create new module directories (e.g., calendar/)
2. Implement tool handlers in separate files
3. Export tool definitions from module index files
4. Import and add tools to TOOLS array in index.js

About

MCP server for Claude to access Outlook data via Microsoft Graph API

Resources

Readme

Activity

Stars

9 stars

Watchers

1 watching

Forks

3 forks

Report repository

Releases

No releases published

Packages 0

No packages published

Languages

• JavaScript 98.7%

• Shell 1.3%

You can’t perform that action at this time.