Microsoft Teams API MCP Server

AI-native Microsoft Teams integration - read conversations, send messages, and manage members via the Teams Chat Service REST API. Its README documents 12 tools, including teams_list_conversations, teams_find_conversation, teams_find_one_on_one. It runs locally over stdio via the published package.

People connecting communication tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · ★ 4 · #27 OF 99 MAINTAINED COMMUNICATION · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Microsoft Teams API

before you install - you'll need

Set TEAMS_LOGIN, TEAMS_AGENT_MARKER, TEAMS_DELETE_TOMBSTONE, TEAMS_PROTECTED_CONVERSATIONS before connecting. TEAMS_TOKEN, TEAMS_BEARER_TOKEN, TEAMS_SUBSTRATE_TOKEN, TEAMS_REGION, TEAMS_DELETE_MODE, TEAMS_AUDIT_LOG are optional or environment-specific per the README.

Claude Code

claude mcp add maxim-mazurok-teams-api -- npx -y teams-api

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "maxim-mazurok-teams-api": {
      "command": "npx",
      "args": [
        "-y",
        "teams-api"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package teams-api - unscoped; check the name against the project README before installing

registry namespace io.github.Maxim-Mazurok is GitHub-verified and matches the repo owner

03 · What Microsoft Teams API can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list available conversations, find a conversation by topic or member name, find a 1:1 chat with a person, and search the organization directory.

The 12 tools it gives your agent

Extracted from the project's README - what Microsoft Teams API lets an agent do.

teams_list_conversations
- List available conversations
teams_find_conversation
- Find a conversation by topic or member name
teams_find_one_on_one
- Find a 1:1 chat with a person
teams_find_people
- Search the organization directory
teams_find_chats
- Search chats by name or member
teams_get_messages
- Get messages from a conversation
teams_send_message
- Send a message to a conversation
teams_get_members
- List members of a conversation
teams_get_transcript
- Get a meeting transcript from a recorded conversation
teams_download_file
- Download message files and inline images
teams_describe_image
- Describe an inline Teams image with a vision model
teams_whoami
- Get the authenticated user's display name

Latest releases

v1.6.2 · 2026-08-12

1.6.2 (2026-08-12)

v1.6.1 · 2026-08-10

1.6.1 (2026-08-10) · guard mentions and emotions against non-array payloads

v1.6.0 · 2026-07-23

1.6.0 (2026-07-23) · add entities as direct dependency for npx compatibility · auto-recover from stale SingletonLock on browser launch failure (#45) (04c6634), closes #44 · omit binary blobs from MCP responses · prefer…

04 · Who maintains Microsoft Teams API

Microsoft Teams API is maintained by maxim-mazurok. We track 2 MCP servers from maxim-mazurok - 2 actively maintained, 4 combined GitHub stars, oldest repo from Mar 2026.

05 · Facts

category
communication - ranked #27 of 99 actively-maintained communication servers as of 2026-08-25.
release cadence
3 releases in the last 90 days (latest 2026-08-12)
registry
io.github.Maxim-Mazurok/teams-api (active, first published 2026-03-19 · 50 versions)
packages
npm:teams-api

06 · Microsoft Teams API FAQ

Is Microsoft Teams API still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12 and it shipped 3 releases in the last 90 days. We re-verify nightly.

What can Microsoft Teams API do?

With this server connected, an agent can list available conversations, find a conversation by topic or member name, find a 1:1 chat with a person, and search the organization directory.

How do I install Microsoft Teams API?

Run `npx -y teams-api`. The README documents 10 environment variables (TEAMS_LOGIN, TEAMS_TOKEN, TEAMS_BEARER_TOKEN…) to set first. Set TEAMS_LOGIN, TEAMS_AGENT_MARKER, TEAMS_DELETE_TOMBSTONE, TEAMS_PROTECTED_CONVERSATIONS before connecting. TEAMS_TOKEN, TEAMS_BEARER_TOKEN, TEAMS_SUBSTRATE_TOKEN, TEAMS_REGION, TEAMS_DELETE_MODE, TEAMS_AUDIT_LOG are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Microsoft Teams API run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Microsoft Teams API

More communication MCP servers · Telegram (MCP-telegram) · Relay · JMAP Email · Intercom

More TypeScript MCP servers · Adrkit Decision Memory · Apimesh · X402 List MCP · MCPfinder - MCP Server Discovery · see all