Microsoft 365 Admin
Microsoft 365 administration via Graph API application permissions (read-only by default).
- 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-serverAdd 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').RequiredMS365_ADMIN_MCP_CLIENT_IDApp registration client ID with the required application permissions.RequiredMS365_ADMIN_MCP_CLIENT_SECRETApp registration client secret. Prefer Azure Key Vault via MS365_ADMIN_MCP_KEYVAULT_URL for production.RequiredMS365_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.