Skip to content
MCP server

Iris

Microsoft 365 mail MCP: reads mail, drafts into Outlook; sending is opt-in…

Runs locallyStatus and history
Install
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-mcp

Add 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.Required
  • IRIS_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.

How AIPoweredBot checks servers