Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
julianobarbosa avatar

Teams Migration

  • 45 installs
  • 6 repo stars
  • Updated July 22, 2026
  • julianobarbosa/claude-code-skills

Migrate MS Teams chat content to channels or between chats. Use when migrating chat, copying messages, moving chat history, backing up Teams content.

About

Migrate MS Teams chat content to channels or between chats.. Use for Teams migration, chat copying, message moving, history backup.

  • intermediate skill
  • core: office & documents

Teams Migration by the numbers

  • 45 all-time installs (skills.sh)
  • +1 installs in the week ending Aug 2, 2026 (Skillselion tracking)
  • Ranked #377 of 688 Office & Documents skills by installs in the Skillselion catalog
  • Data as of Aug 3, 2026 (Skillselion catalog sync)
npx skills add https://github.com/julianobarbosa/claude-code-skills --skill teams-migration

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs45
repo stars6
Last updatedJuly 22, 2026
Repositoryjulianobarbosa/claude-code-skills

What it does

Migrate MS Teams chat content to channels or between chats. Use when migrating chat, copying messages, moving chat history, backing up Teams content.

Files

SKILL.mdMarkdownGitHub ↗

Customization

Before executing, check for user customizations at: ~/.claude/skills/PAI/USER/SKILLCUSTOMIZATIONS/TeamsMigration/

If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults.

Voice Notification

You MUST send this notification BEFORE doing anything else when this skill is invoked.

1. Send voice notification:

   curl -s -X POST http://localhost:8888/notify \
     -H "Content-Type: application/json" \
     -d '{"message": "Running the WORKFLOWNAME workflow in the TeamsMigration skill to ACTION"}' \
     > /dev/null 2>&1 &

2. Output text notification:

   Running the **WorkflowName** workflow in the **TeamsMigration** skill to ACTION...

TeamsMigration

Migrate MS Teams meeting chat or group chat content to team channels, preserving sender attribution, timestamps, images, and attachments. Uses the teams-mcp MCP server for reading and the Microsoft Graph API directly for high-volume batch posting with automatic token refresh and rate limiting.

Workflow Routing

WorkflowTriggerFile
MigrateChat"migrate chat", "copy chat to channel", "move messages"Workflows/MigrateChat.md
ExportChat"export chat", "backup chat", "download messages"Workflows/ExportChat.md

Examples

Example 1: Migrate a meeting chat to a team channel

User: "Migrate the Teams meeting chat to the DevOps channel"
--> Invokes MigrateChat workflow
--> Verifies auth, fetches all messages with pagination
--> Filters system/deleted messages, reverses to chronological order
--> Posts each message with sender + timestamp attribution
--> Verifies count parity and spot-checks content

Example 2: Export chat messages to a local file

User: "Export all messages from our DevOps chat"
--> Invokes ExportChat workflow
--> Fetches all messages with full pagination
--> Saves to JSON file with metadata

Quick Reference

  • MCP Server: @floriscornel/teams-mcp (npm)
  • Auth file: ~/.msgraph-mcp-auth.json
  • Token cache: ~/.teams-mcp-token-cache.json
  • Auth command: npx @floriscornel/teams-mcp@latest authenticate
  • Migration tool: Tools/MigrateChat.mjs (Node.js, no dependencies)

Key Learnings

  • Graph API `descending: false` not supported -- fetch descending, reverse array
  • `download_message_hosted_content` only works for channel messages, not chat messages
  • Token auto-refresh via MSAL refresh token in ~/.teams-mcp-token-cache.json
  • Rate limiting handled by respecting Retry-After header on 429 responses
  • For bulk posting (50+ messages) use Tools/MigrateChat.mjs directly via Graph API instead of MCP tool calls
  • Account must have Teams license -- Chat.* endpoints fail without it (403)

---

Gotchas

  • Graph API ignores `descending: false` on chat messages: Endpoint silently returns descending order anyway. Always fetch descending, reverse the array locally — assuming ascending will post messages in reverse chronological order to the destination.
  • `download_message_hosted_content` works only for channel messages, not chat messages: Images in meeting/group chats need a different code path through /chats/{id}/messages/{id}/hostedContents. Calling it on a chat message returns 404 with a misleading "content not found".
  • MSAL refresh token in `~/.teams-mcp-token-cache.json` expires after 90 days idle: First migration after a long gap fails with AADSTS700082. Re-run npx @floriscornel/teams-mcp@latest authenticate — token refresh is silent until it isn't.
  • *`Chat. Graph endpoints require a Teams license on the calling account:** Service accounts without a license return 403 with text that mentions permissions, not licensing. Verify with az ad user show --id <upn> --query assignedLicenses` before debugging Graph scopes.
  • MCP tool calls hit a per-second rate limit around 50 messages: Bulk migrations through the MCP layer get throttled into hours. For 50+ messages, bypass MCP and use Tools/MigrateChat.mjs directly against Graph with Retry-After handling.
  • Posting preserves sender name in body text, not metadata: The destination channel shows the migration bot as the author, with the original sender embedded in the message text. Compliance/eDiscovery queries on author will miss migrated content entirely.

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.