Skip to content
MCP server

Microsoft 365 Admin

Microsoft 365 administration via Graph API application permissions (read-only by default).

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.6.3
Listing updated
5 days ago

About Microsoft 365 Admin

Microsoft 365 Admin is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add ms-365-admin --env MS365_ADMIN_MCP_TENANT_ID='<MS365_ADMIN_MCP_TENANT_ID>' --env MS365_ADMIN_MCP_CLIENT_ID='<MS365_ADMIN_MCP_CLIENT_ID>' --env MS365_ADMIN_MCP_CLIENT_SECRET='<MS365_ADMIN_MCP_CLIENT_SECRET>' -- npx -y @okapi-ca/ms-365-admin-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ms-365-admin": {
      "command": "npx",
      "args": [
        "-y",
        "@okapi-ca/ms-365-admin-mcp-server"
      ],
      "env": {
        "MS365_ADMIN_MCP_TENANT_ID": "<MS365_ADMIN_MCP_TENANT_ID>",
        "MS365_ADMIN_MCP_CLIENT_ID": "<MS365_ADMIN_MCP_CLIENT_ID>",
        "MS365_ADMIN_MCP_CLIENT_SECRET": "<MS365_ADMIN_MCP_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ms-365-admin": {
      "command": "npx",
      "args": [
        "-y",
        "@okapi-ca/ms-365-admin-mcp-server"
      ],
      "env": {
        "MS365_ADMIN_MCP_TENANT_ID": "<MS365_ADMIN_MCP_TENANT_ID>",
        "MS365_ADMIN_MCP_CLIENT_ID": "<MS365_ADMIN_MCP_CLIENT_ID>",
        "MS365_ADMIN_MCP_CLIENT_SECRET": "<MS365_ADMIN_MCP_CLIENT_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "ms-365-admin": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@okapi-ca/ms-365-admin-mcp-server"
      ],
      "env": {
        "MS365_ADMIN_MCP_TENANT_ID": "<MS365_ADMIN_MCP_TENANT_ID>",
        "MS365_ADMIN_MCP_CLIENT_ID": "<MS365_ADMIN_MCP_CLIENT_ID>",
        "MS365_ADMIN_MCP_CLIENT_SECRET": "<MS365_ADMIN_MCP_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ms-365-admin": {
      "command": "npx",
      "args": [
        "-y",
        "@okapi-ca/ms-365-admin-mcp-server"
      ],
      "env": {
        "MS365_ADMIN_MCP_TENANT_ID": "<MS365_ADMIN_MCP_TENANT_ID>",
        "MS365_ADMIN_MCP_CLIENT_ID": "<MS365_ADMIN_MCP_CLIENT_ID>",
        "MS365_ADMIN_MCP_CLIENT_SECRET": "<MS365_ADMIN_MCP_CLIENT_SECRET>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ms-365-admin": {
      "command": "npx",
      "args": [
        "-y",
        "@okapi-ca/ms-365-admin-mcp-server"
      ],
      "env": {
        "MS365_ADMIN_MCP_TENANT_ID": "<MS365_ADMIN_MCP_TENANT_ID>",
        "MS365_ADMIN_MCP_CLIENT_ID": "<MS365_ADMIN_MCP_CLIENT_ID>",
        "MS365_ADMIN_MCP_CLIENT_SECRET": "<MS365_ADMIN_MCP_CLIENT_SECRET>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • MS365_ADMIN_MCP_TENANT_IDAzure AD tenant ID (specific GUID, not 'common').Required
  • MS365_ADMIN_MCP_CLIENT_IDApp registration client ID with the required application permissions.Required
  • MS365_ADMIN_MCP_CLIENT_SECRETApp registration client secret. Prefer Azure Key Vault via MS365_ADMIN_MCP_KEYVAULT_URL for production.Required
  • MS365_ADMIN_MCP_KEYVAULT_URLOptional Azure Key Vault URL. When set, secrets are pulled from the vault and override the env-var values above.
  • MS365_ADMIN_MCP_CLOUD_TYPECloud environment: 'global' (default) or 'china' (21Vianet).
  • MS365_ADMIN_MCP_MAX_TOPCap on the $top query parameter to limit result size.
  • READ_ONLYSet to 'true' or '1' to force read-only mode (default behavior; mutations require --allow-writes).
  • ENABLED_TOOLSRegex to filter the catalog of available tools.

Pricing

Open source

Microsoft 365 Admin FAQ

Is Microsoft 365 Admin free?

Yes. Microsoft 365 Admin is open source, so you can use and self-host it for free.

How do I add Microsoft 365 Admin to Claude Code?

Run this command in your terminal: claude mcp add ms-365-admin --env MS365_ADMIN_MCP_TENANT_ID='<MS365_ADMIN_MCP_TENANT_ID>' --env MS365_ADMIN_MCP_CLIENT_ID='<MS365_ADMIN_MCP_CLIENT_ID>' --env MS365_ADMIN_MCP_CLIENT_SECRET='<MS365_ADMIN_MCP_CLIENT_SECRET>' -- npx -y @okapi-ca/ms-365-admin-mcp-server

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers