Outlook MCP
📇 ☁️ - Ask your AI assistant to search your inbox, send emails, schedul
What is Outlook MCP?
Outlook MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 📇 ☁️ - ask your ai assistant to search your inbox, send emails, schedul
📇 ☁️ - Ask your AI assistant to search your inbox, send emails, schedul
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP protocol support
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @littlebearapps/outlook-assistantManual Installation
npx -y @littlebearapps/outlook-assistantConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Outlook MCP
The Outlook Assistant MCP Server connects AI clients to Microsoft Outlook and Microsoft 365 accounts via the Microsoft Graph API, providing 22 tools for email search, reading, sending, calendar management, contact lookup, and mailbox organization. It supports delegated OAuth authentication for personal and organizational Microsoft accounts, enabling developers and professionals to manage their entire Outlook inbox and calendar through natural-language conversations.
Prerequisites
- Node.js 18.0.0 or higher
- A Microsoft account (personal, work, or school) or Microsoft 365 subscription
- An Azure app registration with Microsoft Graph delegated permissions (free Azure account sufficient)
- An MCP-compatible client such as Claude Desktop, Claude Code, Cursor, or Windsurf
Register an Azure app for Microsoft Graph access
Go to the Azure Portal (portal.azure.com), create a new App Registration, and set the redirect URI to http://localhost:3333/auth/callback. Select 'Accounts in any organizational directory and personal Microsoft accounts'.
Grant Microsoft Graph delegated permissions
In your app registration under API Permissions, add these Microsoft Graph delegated permissions: offline_access, User.Read, Mail.Read, Mail.ReadWrite, Mail.Send, Calendars.Read, Calendars.ReadWrite, Contacts.Read, Contacts.ReadWrite, MailboxSettings.ReadWrite, People.Read. Grant admin consent if required.
Create a client secret
In Certificates & Secrets, create a new client secret. Copy the Value (not the ID) immediately — it is only shown once. Also copy your Application (client) ID from the Overview page.
Add the server to your MCP client configuration
Add the outlook entry to your claude_desktop_config.json using your client ID and secret value.
Authenticate with Microsoft on first use
The first time you use an email or calendar tool, ask your AI to authenticate. It will call the auth tool which provides a device code. Visit microsoft.com/devicelogin, enter the code, and sign in with your Microsoft account.
Complete authentication and verify access
After signing in, ask the AI to complete authentication. Tokens are saved to ~/.outlook-assistant-tokens.json and auto-refresh. Then try a simple email search to confirm everything works.
Outlook MCP Examples
Client configuration
claude_desktop_config.json entry for the Outlook Assistant MCP Server. Replace the env values with your Azure app credentials.
{
"mcpServers": {
"outlook": {
"command": "npx",
"args": ["-y", "@littlebearapps/outlook-assistant"],
"env": {
"OUTLOOK_CLIENT_ID": "your-azure-application-client-id",
"OUTLOOK_CLIENT_SECRET": "your-client-secret-value"
}
}
}
}Prompts to try
Sample prompts for email, calendar, and contact management once authenticated.
- "Search my inbox for emails from [email protected] about the Q3 budget"
- "Send an email to [email protected] summarizing today's meeting notes"
- "Show me my calendar events for this week"
- "Schedule a 30-minute meeting with [email protected] tomorrow at 2pm"
- "Find the contact details for Sarah Johnson in my organization directory"
- "Check the headers of this email for phishing indicators"Troubleshooting Outlook MCP
Authentication fails with AADSTS errors during device code login
Verify that your app registration has 'Allow public client flows' enabled in Authentication settings. Also confirm the account type selected during app creation matches the Microsoft account you are signing in with.
Mail or calendar tools return 403 Forbidden errors
Check that all required Microsoft Graph permissions are added and that admin consent has been granted if your organization requires it. In the Azure Portal, go to API Permissions and click 'Grant admin consent for [tenant]'.
OUTLOOK_CLIENT_SECRET is rejected with invalid_client error
Ensure you copied the client secret Value, not the Secret ID. Secret values look like a random string; IDs look like a GUID. If unsure, delete the old secret and create a new one.
Frequently Asked Questions about Outlook MCP
What is Outlook MCP?
Outlook MCP is a Model Context Protocol (MCP) server that 📇 ☁️ - ask your ai assistant to search your inbox, send emails, schedul It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Outlook MCP?
Install via npm with the command: npx -y @littlebearapps/outlook-assistant. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Outlook MCP?
Outlook MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Outlook MCP free to use?
Yes, Outlook MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Outlook MCP Alternatives — Similar Communication Servers
Looking for alternatives to Outlook MCP? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Outlook MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Outlook MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.