Outlook Attachments
📇 ☁️ 🏠 🪟 - Remote HTTP MCP serv
What is Outlook Attachments?
Outlook Attachments is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 📇 ☁️ 🏠 🪟 - remote http mcp serv
📇 ☁️ 🏠 🪟 - Remote HTTP MCP serv
This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP protocol support
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx claude-read-outlook-attachmentsConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Outlook Attachments
Claude-MCP-Read-Email-Attachments is a remote HTTP MCP server that gives Claude access to your Microsoft 365 Outlook inbox. It supports listing recent messages, reading email bodies, listing and downloading attachments, and sending emails with local file attachments — all authenticated via Microsoft Entra (Azure AD) using the device code flow.
Prerequisites
- Node.js 20 or later installed
- A Microsoft 365 account (personal or work/school)
- An Azure Entra app registration with delegated permissions: User.Read, Mail.ReadWrite, Mail.Send
- Claude Desktop installed
- Git to clone the repository
Clone the repository and install dependencies
Download the project and install all Node.js dependencies.
git clone https://github.com/Zacccck/Claude-MCP-Read-Email-Attachments.git
cd Claude-MCP-Read-Email-Attachments
npm installCreate an Azure Entra app registration
In the Azure Portal (portal.azure.com), go to Azure Active Directory > App registrations > New registration. Set the redirect URI to a public client/native URI. Under API permissions add Mail.ReadWrite, Mail.Send, and User.Read (all delegated). Copy the Application (client) ID for the next step.
Configure the .env file
Copy the example environment file and set your Azure app credentials. M365_CLIENT_ID is required; the other variables are optional.
cp .env.example .env
# Edit .env:
# M365_CLIENT_ID=your-azure-app-client-id
# M365_TENANT_ID=common # or your specific tenant ID
# M365_AUTO_OPEN_BROWSER=true # auto-open browser for login
# M365_SEND_MAX_BYTES=3145728 # 3 MB attachment limit
# M365_MCP_DATA_DIR=~/.m365-mcp # auth token cache locationAdd the server to Claude Desktop configuration
Register the MCP server in Claude Desktop's config file so it launches the local Node.js server on startup.
{
"mcpServers": {
"outlook-attachments": {
"command": "node",
"args": ["/absolute/path/to/Claude-MCP-Read-Email-Attachments/index.js"],
"env": {
"M365_CLIENT_ID": "your-azure-app-client-id",
"M365_TENANT_ID": "common"
}
}
}
}Authenticate with Microsoft 365
After restarting Claude Desktop, ask Claude to begin the authentication flow. A device code or browser window will appear for Microsoft login.
Verify authentication and list emails
Confirm the auth status, then start reading emails and attachments.
Outlook Attachments Examples
Client configuration
Claude Desktop configuration for the Outlook Attachments MCP server.
{
"mcpServers": {
"outlook-attachments": {
"command": "node",
"args": ["/path/to/Claude-MCP-Read-Email-Attachments/index.js"],
"env": {
"M365_CLIENT_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"M365_TENANT_ID": "common",
"M365_AUTO_OPEN_BROWSER": "true",
"M365_SEND_MAX_BYTES": "3145728"
}
}
}
}Prompts to try
Example prompts to use after authenticating with Microsoft 365.
- "Please call begin_auth to sign me into my Microsoft account"
- "List my 10 most recent Outlook emails"
- "Find the latest invoice email and extract all line items from the PDF attachment"
- "Read the body of the email from my manager yesterday"
- "Send an email to [email protected] with the file ~/reports/Q2.xlsx attached"Troubleshooting Outlook Attachments
begin_auth returns 'AADSTS70011: The provided request must include a scope'
In your Entra app registration, ensure the delegated API permissions (User.Read, Mail.ReadWrite, Mail.Send) have been added and admin consent granted if required by your tenant.
Attachment exceeds size limit and read_email_attachment fails
Increase the M365_SEND_MAX_BYTES environment variable (default is 3 MB = 3145728 bytes). Set it to a larger value in your .env file or in the Claude Desktop config env block.
Server starts but Claude shows 'health_check failed'
Confirm Node.js 20+ is installed and that the path in the args array points to the correct index.js file. Run 'node index.js' manually in a terminal to see startup errors.
Frequently Asked Questions about Outlook Attachments
What is Outlook Attachments?
Outlook Attachments is a Model Context Protocol (MCP) server that 📇 ☁️ 🏠 🪟 - remote http mcp serv It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Outlook Attachments?
Follow the installation instructions on the Outlook Attachments GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Outlook Attachments?
Outlook Attachments works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Outlook Attachments free to use?
Yes, Outlook Attachments is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Outlook Attachments Alternatives — Similar File Systems Servers
Looking for alternatives to Outlook Attachments? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.
Electerm
★ 14.1k📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)
Plik
★ 1.8kPlik is a temporary file upload system (Wetransfer like) in Go.
Kordoc
★ 957An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.
macOS Automator
★ 801A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.
PDF Reader
★ 723Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.
Filesystem MCP Server
★ 643Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.
Browse More File Systems MCP Servers
Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Outlook Attachments 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 Attachments?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.