Outlook MCP Server — Hosted Api Connectors Integration
MCP Server language Hosted language PublicManage Outlook email at scale — inbox rules, focused inbox, folders, message search, attachments, and mail flow automation via Microsoft Graph.
Use with AI AssistantsMCP
Connect Claude, Cursor, or any MCP-compatible client — then call tools directly
① Add This MCP Server
Paste into your AI client config — then all its tools are available instantly.
{
"mcpServers": {
"outlook": {
"url": "https://mcp.aerostack.dev/s/aerostack/mcp-outlook",
"headers": {
"Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
}
}
}
}Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.
② Call a Tool
Ask your AI assistant to call a specific tool, or send raw JSON-RPC:
Natural Language Prompt
“Use the _ping tool to verify microsoft outlook credentials by calling a lightweight read endpoint. used internally by aerostack to validate credentials”
Using a Workspace?
Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.
description Overview
mcp-outlook — Outlook MCP Server
Manage Outlook email at scale — inbox rules, focused inbox, folders, message search, attachments, and mail flow automation via Microsoft Graph.
Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-outlook
What You Can Do
This MCP server gives AI agents access to Outlook via 18 tools. Connect it to any Aerostack workspace and your agents can interact with Outlook directly.
Available Tools
| Tool | Description |
|---|---|
list_messages |
List emails with filtering by folder, subject, sender, read status |
get_message |
Get a single email with full body, headers, and attachment metadata |
send_email |
Send an email with HTML or text body, CC, BCC, and importance |
reply_to_message |
Reply to an email (reply or reply-all) |
move_message |
Move a message to a different folder |
list_folders |
List all mail folders with message counts |
create_folder |
Create a new mail folder |
update_folder |
Rename a mail folder |
delete_folder |
Delete a mail folder and all its contents |
search_messages |
Full-text search across emails by keyword, sender, date range |
get_focused_inbox |
List messages from the Focused Inbox (not Other) |
list_inbox_rules |
List all inbox rules (auto-move, auto-reply, etc.) |
create_inbox_rule |
Create an inbox rule to auto-move, categorize, or flag messages |
delete_inbox_rule |
Delete an inbox rule |
list_attachments |
List attachments on a message with size and content type |
get_attachment |
Download an attachment (returns base64 for binary, text for text files) |
get_mailbox_settings |
Get mailbox settings: auto-reply, working hours, locale, time zone |
update_auto_reply |
Configure out-of-office auto-reply settings |
Configuration
| Variable | Required | Description |
|---|---|---|
MICROSOFT_ACCESS_TOKEN |
Yes | Microsoft OAuth 2.0 access token (requires Mail.ReadWrite, Mail.Send, MailboxSettings.ReadWrite scopes) |
Quick Start
Add to Aerostack Workspace
- Go to aerostack.dev → Your Project → MCPs
- Search for "Outlook" and click Add to Workspace
Add the following secrets under Project → Secrets:
MICROSOFT_ACCESS_TOKEN
Once added, every AI agent in your workspace can use Outlook tools automatically.
Direct API Call
curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-outlook \
-H 'Content-Type: application/json' \
-H 'X-Mcp-Secret-MICROSOFT-ACCESS-TOKEN: your-microsoft-access-token' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_messages","arguments":{}}}'
License
MIT
terminal Tools (19)
Available tools on this MCP server. Each tool can be called directly from any AI agent.
_ping #1 Verify Microsoft Outlook credentials by calling a lightweight read endpoint. Used internally by Aerostack to validate credentials.
list_messages #2 List emails with filtering by folder, subject, sender, read status
get_message #3 Get a single email with full body, headers, and attachment metadata
send_email #4 Send an email with HTML or text body, CC, BCC, and importance
reply_to_message #5 Reply to an email (reply or reply-all)
move_message #6 Move a message to a different folder
list_folders #7 List all mail folders with message counts
create_folder #8 Create a new mail folder
update_folder #9 Rename a mail folder
delete_folder #10 Delete a mail folder and all its contents
search_messages #11 Full-text search across emails by keyword, sender, date range
get_focused_inbox #12 List messages from the Focused Inbox (not Other)
list_inbox_rules #13 List all inbox rules (auto-move, auto-reply, etc.)
create_inbox_rule #14 Create an inbox rule to auto-move, categorize, or flag messages
delete_inbox_rule #15 Delete an inbox rule
list_attachments #16 List attachments on a message with size and content type
get_attachment #17 Download an attachment (returns base64 for binary, text for text files)
get_mailbox_settings #18 Get mailbox settings: auto-reply, working hours, locale, time zone
update_auto_reply #19 Configure out-of-office auto-reply settings
Details
language Live Endpoint
https://mcp.aerostack.dev/s/aerostack/mcp-outlook
Sub-50ms globally · Zero cold start
Publisher
Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.
More in API Connectors
Browse API Connectors MCPs →Aerostack Registry
by @aerostack
Discover and invoke any MCP, Function, or Skill published to the Aerostack marketplace — the universal AI capability hub.
Algolia
by @aerostack
Search indexes, manage records, browse data, and configure ranking in Algolia — AI-native instant search access.
Arangodb
by @aerostack
Query documents, run AQL, traverse graphs, and manage collections in your ArangoDB database — AI-native multi-model database access.
Ayrshare
by @aerostack
Post, schedule, and analyze social media across 13 platforms — Facebook, Instagram, X, LinkedIn, TikTok, Bluesky, Threads, Reddit, Pinterest, YouTube, Telegram, Snapchat, Google Business.
Basecamp
by @aerostack
Manage projects, to-dos, messages, schedules, and campfire chats in Basecamp — AI-native project management.
Bigquery
by @aerostack
Run SQL queries, list datasets and tables, inspect schemas, and export results from Google BigQuery — AI-native data warehouse access.
Frequently asked questions
What is the Outlook MCP server and what can it do? +
The Outlook MCP server is hosted on Aerostack and exposes these tools to your AI agent: `_ping`, `list_messages`, `get_message`, `send_email`, `reply_to_message`. You get one hosted URL — no self-hosting — that works from Claude, Cursor, ChatGPT, Gemini, VS Code, or any MCP-compatible client, and you can share it with your team or combine it with other MCP servers in a workspace.
Is the Outlook MCP server hosted, or do I have to run it myself? +
It's hosted on Aerostack's edge infrastructure — you don't deploy or maintain anything. Add it to a workspace and you get one authenticated URL, with secrets encrypted, that any AI agent or editor can connect to. Use it solo or share the same URL across your whole team.
Which AI agents and editors can use the Outlook MCP server? +
Any MCP client: Claude and Claude Code, Cursor, ChatGPT, Gemini, Windsurf, Cline, VS Code, and custom agents. Because it's one hosted URL, the same Outlook MCP server works everywhere — and you can compose it with other MCP servers, skills, and functions behind a single workspace URL.
How do I install the Outlook MCP server in Claude Desktop? +
Add the following to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "@aerostack/mcp-outlook": { "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-outlook"] } } } ``` Then restart Claude Desktop and the tools will appear automatically.
How do I use the Outlook MCP server in Cursor? +
In Cursor, open **Settings → MCP** and add: ```json { "name": "@aerostack/mcp-outlook", "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-outlook"] } ``` Save and reload Cursor. The MCP tools will be available in Agent mode.
Does Outlook MCP require authentication? +
Yes. Outlook requires authentication. Check the MCP's documentation for the required credentials.