MCP server
Iris
Microsoft 365 mail MCP: reads mail, drafts into Outlook; sending is opt-in…
Runs locallyStatus and history
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.3.0
- Listing updated
- 5 days ago
About Iris
Iris is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Microsoft 365 mail MCP: reads mail, drafts into Outlook; sending is opt-in (IRIS_ENABLE_SEND).
Install
Run in a terminal
claude mcp add iris --env IRIS_CLIENT_ID='<IRIS_CLIENT_ID>' -- uvx iris-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"iris": {
"command": "uvx",
"args": [
"iris-mcp"
],
"env": {
"IRIS_CLIENT_ID": "<IRIS_CLIENT_ID>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"iris": {
"command": "uvx",
"args": [
"iris-mcp"
],
"env": {
"IRIS_CLIENT_ID": "<IRIS_CLIENT_ID>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"iris": {
"type": "stdio",
"command": "uvx",
"args": [
"iris-mcp"
],
"env": {
"IRIS_CLIENT_ID": "<IRIS_CLIENT_ID>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"iris": {
"command": "uvx",
"args": [
"iris-mcp"
],
"env": {
"IRIS_CLIENT_ID": "<IRIS_CLIENT_ID>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"iris": {
"command": "uvx",
"args": [
"iris-mcp"
],
"env": {
"IRIS_CLIENT_ID": "<IRIS_CLIENT_ID>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
IRIS_CLIENT_IDApplication (client) ID of YOUR OWN Entra app registration. There is no shared app; you register one.RequiredIRIS_TENANT_IDDirectory (tenant) ID. Defaults to 'organizations'.IRIS_DRAFT_FOLDERMail folder drafts are written to, created on first use. Defaults to 'AI Drafts'. Empty string uses Drafts.IRIS_ALLOWLISTPath to a recipient allowlist file. If absent or empty, all recipients are permitted.IRIS_DISABLE_READSet to '1' to unregister the read tools (list/search/get messages and threads) for a drafts-only surface.IRIS_ENABLE_SENDSet to '1' to enable sending. ALSO requires Mail.Send granted on the Entra app and a fresh sign-in. Off by default; when unset, iris cannot send and the send tool is not registered.
Pricing
Open source
Iris FAQ
Is Iris free?
Yes. Iris is open source, so you can use and self-host it for free.
How do I add Iris to Claude Code?
Run this command in your terminal: claude mcp add iris --env IRIS_CLIENT_ID='<IRIS_CLIENT_ID>' -- uvx iris-mcp
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.