← Index

Microsoft Teams API

io.github.Maxim-Mazurok/teams-api·v1.5.0·Search
Quality Score
90
/100

AI-native Microsoft Teams integration — read chats, send messages, search people

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "teams-api": {
      "command": "npx",
      "args": [
        "-y",
        "teams-api"
      ],
      "env": {
        "TEAMS_EMAIL": "<teams_email>",
        "TEAMS_AUTO": "<teams_auto>",
        "TEAMS_LOGIN": "<teams_login>",
        "TEAMS_TOKEN": "<your-teams_token>",
        "TEAMS_REGION": "<teams_region>",
        "TEAMS_BEARER_TOKEN": "<your-teams_bearer_token>",
        "TEAMS_SUBSTRATE_TOKEN": "<your-teams_substrate_token>",
        "TEAMS_DEBUG": "<teams_debug>",
        "TEAMS_TELEMETRY": "<teams_telemetry>",
        "TEAMS_TELEMETRY_PATH": "<teams_telemetry_path>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "teams-api": {
      "command": "npx",
      "args": [
        "-y",
        "teams-api"
      ],
      "env": {
        "TEAMS_EMAIL": "<teams_email>",
        "TEAMS_AUTO": "<teams_auto>",
        "TEAMS_LOGIN": "<teams_login>",
        "TEAMS_TOKEN": "<your-teams_token>",
        "TEAMS_REGION": "<teams_region>",
        "TEAMS_BEARER_TOKEN": "<your-teams_bearer_token>",
        "TEAMS_SUBSTRATE_TOKEN": "<your-teams_substrate_token>",
        "TEAMS_DEBUG": "<teams_debug>",
        "TEAMS_TELEMETRY": "<teams_telemetry>",
        "TEAMS_TELEMETRY_PATH": "<teams_telemetry_path>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y teams-api
§02  Environment variables
TEAMS_EMAIL

Corporate email address for Teams authentication

TEAMS_AUTO

Set to "true" to use auto-login (macOS + FIDO2)

TEAMS_LOGIN

Set to "true" to use interactive browser login (all platforms)

TEAMS_TOKEN
secret

Pre-existing Skype token for direct authentication

TEAMS_REGION

API region (required with TEAMS_TOKEN, auto-detected otherwise)

TEAMS_BEARER_TOKEN
secret

Middle-tier bearer token for profile resolution

TEAMS_SUBSTRATE_TOKEN
secret

Substrate bearer token for people/chat search

TEAMS_DEBUG

Set to "true" to use Chrome debug session for token capture

TEAMS_TELEMETRY

Set to "true" to enable full debug telemetry logging (contributor use; logs all inputs and outputs locally)

TEAMS_TELEMETRY_PATH

Override the telemetry output file path (default: platform-appropriate ~/Library/... or ~/.local/share/...)

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
15
installability
25
documentation
15
stability
10
§04  Alternatives in Search