Agentbuilder Outlook
- python
0
GitHub Stars
python
Language
7 months ago
First Indexed
3 months ago
Catalog Refreshed
Documentation & install
Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.
This MCP Server lets you send Outlook emails through the Microsoft Graph API by exposing a single send_outlook_mail entry point. It validates payloads, obtains access tokens, and forwards messages to Graph’s sendMail endpoint, enabling multi-tenant usage where each caller provides their own Microsoft credentials.
How to use
To send emails from your applications, connect your MCP-compatible client to the Outlook MCP Server at its remote URL and call the send_outlook_mail tool with your message details. The server supports multi-tenant usage, meaning each request can supply its own access token or client credentials. You can perform a dry run to validate payloads locally before sending real emails.
How to install
Prerequisites:
- Python 3.10+
- Microsoft Outlook/Graph account with Mail.Send permission
- uv or pip
Install the MCP server locally using the Python environment helper:
uv pip install .
Set up environment variables (create a .env file from the template and load it before running):
set -a; source .env; set +a
Additional configuration and usage notes
Remote server URL you can connect to for live usage: https://agentbuilder-outlook-mcp.fastmcp.app/mcp
Local validation before hitting the remote server:
fastmcp run server.py
Security and multi-tenant notes
This MCP server supports multi-tenant usage where each request provides its own Microsoft credentials. The server stores NO credentials and performs authentication per request. There are two supported authentication methods: personal Microsoft accounts (delegated permissions) and organizational accounts (client credentials).
Testing
Run unit tests to verify token handling and payload construction:
uv pip install .[dev]
pytest
Deployment notes
The MCP configuration is prepared for FastMCP deployment. Secrets should be supplied via environment variables on the target platform. If you have additional deployment tasks, reference the deployment checklist to ensure all steps are completed.
Available tools
send_outlook_mail
Main tool to send Outlook emails via Graph API. Validates payloads, handles authentication per request, and calls Graph's sendMail endpoint to deliver messages.
