Teams MCP服务器

# Using make (auto-detects uv for faster installs)
make install
pip install -e ".[persona]"
playwright install chromium

# Or manually with uv
uv venv .venv --python python3.11
uv pip install --python .venv/bin/python -e ".[persona]"
playwright install chromium

cp .env.example .env

TEAMS_MCP_TOKEN_KEY=$(python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())")

teams-mcp
# Server starts on http://localhost:9106

# Join as "Diana" with a face image
curl -s -X POST http://localhost:9106/rpc \
  -H 'Content-Type: application/json' \
  -d '{
    "method": "tools/call",
    "params": {
      "name": "teams.persona.join",
      "arguments": {
        "join_url": "https://teams.microsoft.com/l/meetup-join/...",
        "display_name": "Diana",
        "face_image": "/path/to/diana.png"
      }
    },
    "id": 1
  }'

# Make the persona speak
curl -s -X POST http://localhost:9106/rpc \
  -H 'Content-Type: application/json' \
  -d '{
    "method": "tools/call",
    "params": {
      "name": "teams.persona.speak",
      "arguments": {
        "session_id": "persona-1234567890",
        "text": "Hello everyone, I am Diana, your AI assistant."
      }
    },
    "id": 2
  }'

# Post in meeting chat
curl -s -X POST http://localhost:9106/rpc \
  -H 'Content-Type: application/json' \
  -d '{
    "method": "tools/call",
    "params": {
      "name": "teams.persona.chat_post",
      "arguments": {
        "session_id": "persona-1234567890",
        "text": "Meeting notes will be shared after the call."
      }
    },
    "id": 3
  }'

# Listen to what others are saying
curl -s -X POST http://localhost:9106/rpc \
  -H 'Content-Type: application/json' \
  -d '{
    "method": "tools/call",
    "params": {
      "name": "teams.persona.listen",
      "arguments": {
        "session_id": "persona-1234567890",
        "duration_ms": 5000
      }
    },
    "id": 4
  }'

# Leave
curl -s -X POST http://localhost:9106/rpc \
  -H 'Content-Type: application/json' \
  -d '{
    "method": "tools/call",
    "params": {
      "name": "teams.persona.leave",
      "arguments": {"session_id": "persona-1234567890"}
    },
    "id": 5
  }'

# Connect via HomePilot API (persona mode)
curl -X POST http://localhost:8000/v1/teams/bridge/connect \
  -H 'Content-Type: application/json' \
  -d '{
    "room_id": "room-abc-123",
    "join_url": "https://teams.microsoft.com/l/meetup-join/...",
    "mode": "persona",
    "display_name": "Diana",
    "face_image": "/data/faces/diana.png",
    "tts_voice": "en_US-amy-medium",
    "voice_enabled": true
  }'

# Using make (auto-detects uv for faster installs)
make install

# Or manually with uv
uv venv .venv --python python3.11
uv pip install --python .venv/bin/python -e .

# Or with pip
pip install -e .

python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

cp .env.example .env

TEAMS_MCP_MS_CLIENT_ID=<your Azure app client ID>
TEAMS_MCP_TOKEN_KEY=<the Fernet key from step 2>
TEAMS_MCP_MS_TENANT_ID=common    # or your org tenant ID

teams-mcp
# Server starts on http://localhost:9106

curl -s -X POST http://localhost:9106/rpc \
  -H 'Content-Type: application/json' \
  -d '{"method":"tools/call","params":{"name":"teams.auth.device_code_start","arguments":{}},"id":1}'

curl -s -X POST http://localhost:9106/rpc \
  -H 'Content-Type: application/json' \
  -d '{"method":"tools/call","params":{"name":"teams.auth.device_code_poll","arguments":{"device_code":"YOUR_CODE"}},"id":2}'

curl -s http://localhost:9106/health | python -m json.tool
# Should show 35 tools

                    ┌──────────────────────────────────────────────┐
                    │           Teams MCP Server :9106              │
                    │                                              │
                    │  NATIVE MODE (27 tools)                      │
  MS Graph API ───>│    Auth · Chat · Calendar · Meetings          │<── Any MCP Client
                    │    Voice/STT · ACS Audio                     │
                    │                                              │
                    │  PERSONA MODE (8 tools)                      │
  Headless        >│    Join · Leave · Status · Set Face           │
  Chromium         │    Speak · Listen · Chat Post · Chat Read     │
                    │                                              │
                    │  Endpoints:   GET /health     POST /rpc      │
                    └──────────────────────────────────────────────┘

HomePilot                              teams-mcp-server
   │
   │── teams.persona.join ────────────► Launch headless Chromium
   │   {url, name, face_image}          Navigate to meeting URL
   │                                    Click "Join as guest"
   │                                    ◄── {session_id}
   │
   │── teams.persona.speak ───────────► piper-tts generates WAV
   │   {session_id, text}               Play to virtual mic
   │                                    Meeting hears persona speak
   │
   │── teams.persona.listen ──────────► Capture tab audio
   │   {session_id}                     Whisper STT transcribes
   │                                    ◄── {transcript}
   │
   │── teams.persona.chat_post ───────► Type in chat via DOM
   │── teams.persona.chat_read ───────► Scrape chat via DOM
   │── teams.persona.leave ───────────► Click Leave, close browser

Your Company's Teams Meeting
    |
    |  Microsoft Graph API (reads YOUR chat as YOU)
    v
teams-mcp-server (localhost:9106)
    |
    |  JSON-RPC
    v
HomePilot (localhost)
    |
    └── Personas read meeting chat, react, post responses back

# Using make (creates venv + installs deps automatically)
make test

# Or manually
pip install -e ".[test]"
pytest -v

- name: hp-teams
  url: "http://localhost:9106/rpc"
  transport: "HTTP"
  description: "Microsoft Teams MCP server"

- id: hp-teams
  port: 9106
  description: "Microsoft Teams chats, channels, calendar, meetings, and persona join"
  category: communication
  auth_type: "Device Code"
  source:
    type: external
    git: https://github.com/ruslanmv/teams-mcp-server
    ref: master

┌──────────────────────────────────────────────────────────────────┐
│                     Teams MCP Server :9106                        │
│                                                                  │
│  NATIVE MODE                           PERSONA MODE              │
│  ┌─────────┐ ┌────────┐ ┌──────────┐  ┌──────────────────────┐  │
│  │  Auth    │ │  Chat  │ │ Calendar │  │  Persona Meeting     │  │
│  │ 4 tools │ │ 2 tools│ │ 3 tools  │  │  8 tools             │  │
│  └────┬────┘ └───┬────┘ └────┬─────┘  │                      │  │
│       │          │           │         │  join · leave · face  │  │
│  ┌────┴──────────┴───────────┴──┐      │  speak · listen      │  │
│  │   Microsoft Graph Client     │      │  chat_post/read      │  │
│  │   (auth/ + graph/)           │      └──────────┬───────────┘  │
│  └──────────────────────────────┘                  │              │
│                                                    ▼              │
│  ┌─────────┐ ┌──────────┐ ┌──────────┐  ┌────────────────────┐  │
│  │ Voice   │ │ Meeting  │ │   ACS    │  │  Browser Engine    │  │
│  │ 4 tools │ │ Sessions │ │ 3 tools  │  │  (Playwright)      │  │
│  └────┬────┘ │ 3 tools  │ └──────────┘  │                    │  │
│       │      └──────────┘                │  Headless Chromium │  │
│       ▼                                  │  + Virtual Cam     │  │
│  ┌────────────────────┐                  │  + Virtual Mic     │  │
│  │   STT Pipeline     │◄────────────────►│  + Tab Audio Cap   │  │
│  │  Whisper|Deepgram  │   (shared)       │  + DOM Chat I/O    │  │
│  └────────────────────┘                  └────────────────────┘  │
│                                                                  │
│  ┌────────────────────┐                  ┌────────────────────┐  │
│  │   TTS Pipeline     │                  │  Face Video Gen    │  │
│  │   Piper (local)    │                  │  OpenCV (idle anim)│  │
│  └────────────────────┘                  └────────────────────┘  │
│                                                                  │
│  Endpoints:   GET /health     POST /rpc                          │
└──────────────────────────────────────────────────────────────────┘
         ▲                              ▲
         │  MS Graph API / Chromium     │  JSON-RPC
         │                              │
    MS Teams                    HomePilot / MCP Client

cd docker
docker compose up -d

Copyright 2026 Teams MCP Server Contributors

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.