Microsoft Teams × Metabase

How to build Microsoft Teams dashboards in Metabase

Microsoft Teams is a Microsoft 365 collaboration hub for teams, channels, chats, meetings, messages, and files. Metabase is where you turn that operational activity into shared, trustworthy dashboards. This guide covers two complementary paths: a lightweight MCP + CLI routethat pulls live data with the Work IQ Teams MCP Server and loads a CSV into Metabase with the Metabase CLI, and a durable pipeline route that syncs Microsoft Teams into a database so you can build dashboards anyone can read.

Heads up: Metabase connects to databases and warehouses — it does not ship a native Microsoft Teams connector. For dashboards that need history and reliability, sync Microsoft Teams into a database first.

How do you connect Microsoft Teams to Metabase?

Most teams combine both routes: use MCP and CLI uploads for a fast first pass, then move recurring reporting to a warehouse-backed model.

1 · MCP + CLI route (AI-assisted)

Live data in, quick analysis out

Pair the Work IQ Teams MCP Server with the Metabase CLI. Use MCP for live lookups, write the result to CSV, then load it into Metabase as a ready-to-query table and model.

Best for
  • Quick lookups such as "show me channel and team activity"
  • Loading a Microsoft Teams CSV export into Metabase in seconds
  • Spot-checks and one-off analyses without a warehouse
Trade-offs
  • Great for exploration, not governed reporting
  • Use read-only/scoped credentials wherever the MCP server supports them
  • CSV uploads are snapshots — refresh or move to the pipeline for history
2 · Pipeline route (warehouse-backed)

Durable dashboards with history

Sync Microsoft Teams into a database or warehouse with a managed connector, custom pipeline, or API, then point Metabase at it.

Best for
  • Microsoft Teams dashboards leaders depend on
  • Joining Microsoft Teams data with product, support, sales, or engineering data
  • Long-run trends for channel and team activity and collaboration response time
Trade-offs
  • You own the refresh schedule and clean data model
  • Change and activity history need explicit snapshots, events, or changelog syncs
  • Metric definitions must be consistent across tools and teams

What can you analyze from Microsoft Teams data in Metabase?

  • Channel and team activity — built from messages and the related teams, channels, chats data your sync exposes.
  • Collaboration response time — built from messages and the related teams, channels, chats data your sync exposes.
  • Meeting and message volume — built from messages and the related teams, channels, chats data your sync exposes.
  • Inactive teams and channels — built from messages and the related teams, channels, chats data your sync exposes.
  • Cross-team participation — built from messages and the related teams, channels, chats data your sync exposes.

Which Microsoft Teams dashboards should you build in Metabase?

For: Operations and program owners

Microsoft Teams overview

The shared operating view to build first.

  • Channel and team activity
  • Collaboration response time
  • Meeting and message volume
For: Content and workspace owners

Coverage, freshness, and activity

The deeper views that expose risk and cleanup work.

  • Inactive teams and channels
  • Cross-team participation

How do you use the Work IQ Teams MCP Server with the Metabase CLI?

Pair the Work IQ Teams MCP Server with the Metabase CLI for fast, hands-on analysis. MCP is useful for scoped lookups and exports; the Metabase CLI's upload command loads CSV data into Metabase and creates a ready-to-query table and model.

Example workflow

  • Ask the MCP server for recent activity, unanswered threads, or inactive messages.
  • Export the result as CSV, keeping stable IDs, owners, containers, status or type, and timestamps.
  • Run mb upload csv to load it into Metabase as a table and model, then build questions and dashboards on top.

Be honest about the limits

  • MCP lookups are excellent for exploration, not scheduled reporting.
  • A CSV upload is a snapshot; refresh it with mb upload replace or move to the pipeline for real history.
  • Thread and event timestamps are required for response-time and activity trends.
  • mb upload csv needs an uploads database configured under Admin → Settings → Uploads.

How do you set up Microsoft Teams MCP and the Metabase CLI?

Work IQ Teams MCP Serverofficial

Transport
Tenant-scoped hosted MCP (preview)
Auth
Microsoft Entra ID with Work IQ permissions
Best for
Live scoped lookup and export

Metabase CLIofficial

Install
npm install -g @metabase/cli
Auth
mb auth login
Load data
mb upload csv --file data.csv
Requires
An uploads database (Admin → Settings → Uploads)
MCPExample MCP client config
{
  "mcpServers": {
    "teams": {
      "url": "https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_TeamsServer"
    }
  }
}
TerminalLoad a Microsoft Teams CSV with the Metabase CLI
# Install the Metabase CLI
npm install -g @metabase/cli

# Log in (opens your browser; requires Metabase v62+)
mb auth login --url https://your-metabase.example.com

# Load a messages export — creates a table AND a model
mb upload csv --file microsoft-teams-messages.csv --collection root

# Refresh that same table later from a new export
mb upload replace <table-id> --file microsoft-teams-messages.csv

Can you generate a Microsoft Teams dashboard with AI?

Yes. Use the prompt below with any assistant that can run the Work IQ Teams MCP Server and the Metabase CLI. It works end to end: if Microsoft Teams tables already exist in Metabase it analyzes those; otherwise it pulls scoped data over MCP, loads it with mb upload csv, then builds the dashboard and caveats any metric that needs missing history.

Prompt for creating a Microsoft Teams Collaboration Activity Overview dashboard
Create a polished Metabase dashboard for Microsoft Teams collaboration activity analytics.
Work end to end: get the data into Metabase if it isn't there yet, then build.

Goal: Help team and program leaders understand workspace activity, response time, participation, inactive areas, and collaboration load from Microsoft Teams data.

Step 1 — Find or load the data:
- First, check what already exists in Metabase (search for microsoft-teams tables and
  models). If durable Microsoft Teams data is already present — synced from a warehouse
  or uploaded earlier — use it and skip to Step 2.
- If nothing is there, pull a scoped export with the Work IQ Teams MCP Server: messages,
  teams, channels, chats. Write each result to a CSV, then
  load it with the Metabase CLI — run "mb upload csv --file <export>.csv" so each
  upload creates a table and a ready-to-query model. Use "mb upload replace <table-id>
  --file <export>.csv" to refresh an existing table instead of creating duplicates.

Step 2 — Inspect before querying:
Do not assume exact table or column names. Inspect available fields, dates, owners,
containers, status values, and whether change/activity history exists before creating
duration or trend cards.

Important:
- Build on whatever data is present; don't claim Metabase connects natively to
  Microsoft Teams — it reads a database or CLI-uploaded tables.
- Only compute durations when the required start/end or event timestamps exist.
- Exclude archived, deleted, canceled, or test objects from active-population cards.
- Avoid individual performance leaderboards; use owner views for balancing and cleanup.
- A single CSV is a point-in-time snapshot: only build trend cards if there is a
  usable date column or multiple periods have been uploaded.

Dashboard title: Microsoft Teams Collaboration Activity Overview

Sections:
1. Executive summary: Active spaces; Activity last 30 days; Median response time;
   Inactive spaces; Active contributors.
2. Activity: Events by week, workspace, channel, or project.
3. Response: First-response distribution and unresolved threads when available.
4. Participation: Contributors and collaboration load by team or workspace.
5. Lifecycle: Newly active, declining, and inactive spaces or channels.

Filters: Date range, Project/board/database, Status, Owner, Team, Work type.

Output: Build the dashboard if you have permission; otherwise provide the exact
questions, SQL, model definitions, and layout. Include caveats for any metric
that cannot be calculated from the available data.

How do you sync Microsoft Teams data into a database or warehouse?

For dashboards that need history and reliability, land Microsoft Teams data in a database first, then connect Metabase to that database.

Connector options

  • Managed ETL — use a connector when one covers the objects you need.
  • Custom pipeline — use the Microsoft Graph Teams APIs for control over fields, history, and refresh cadence.
  • MCP + CSV — use this for quick exploration and one-off slices.

Use Microsoft Graph exports and APIs for durable reporting on teams, channels, chats, messages, meetings, users, and membership; review compliance and retention requirements first.

Notes

  • Land raw tables first, then build clean Metabase models on top.
  • Keep change events or daily snapshots if you need trends and duration metrics.
  • Normalize actor, container, event type, thread, created, and response-time fields.

How should you model Microsoft Teams data in Metabase?

Core tables

TableGrainKey columns
teams_messagesone row per channel or chat messagemessage_id, team_id, channel_id, chat_id, sender_id, reply_to_id, created_at, modified_at
teams_channelsone row per channelchannel_id, team_id, name, membership_type, created_at
teams_meetingsone row per online meetingmeeting_id, organizer_id, start_at, end_at, subject, attendee_count

Modeling advice

  • Build a clean collaboration_events model with common columns across tools.
  • Separate current-state fields from change events, activity, or snapshot history.
  • Exclude archived, deleted, test, and duplicate objects from active-population metrics.
  • Use stable IDs for owner, project, and item joins; display names can change.

Which Microsoft Teams metrics should you track in Metabase?

MetricDefinitionNotes
Workspace activity rateActive workspaces, teams, or channels ÷ eligible containers.Use a meaningful activity threshold.
Collaboration response timeElapsed time from a question or thread to its first useful reply.Report median and p90.
Knowledge-base coverageImportant collaboration areas linked to owned, current guidance.Do not equate message volume with knowledge.

What SQL powers Microsoft Teams dashboards in Metabase?

These assume a cleaned analytical model in a warehouse (PostgreSQL dialect). Adjust table and column names to match your connector.

Workspace activity by weekPostgreSQL

Events and distinct contributors by container.

SELECT
  date_trunc('week', occurred_at) AS week,
  container_name,
  COUNT(*) AS activity_events,
  COUNT(DISTINCT actor_id) AS active_contributors
FROM collaboration_events
GROUP BY 1, 2
ORDER BY 1, 2;
Median first-response timePostgreSQL

First useful reply by thread-created week.

SELECT
  date_trunc('week', thread_created_at) AS week,
  percentile_cont(0.5) WITHIN GROUP (
    ORDER BY EXTRACT(EPOCH FROM (first_reply_at - thread_created_at)) / 3600.0
  ) AS median_first_response_hours
FROM collaboration_threads
WHERE first_reply_at IS NOT NULL
GROUP BY 1
ORDER BY 1;

What are common mistakes when analyzing Microsoft Teams in Metabase?

Treating current-state exports as history.→ Keep snapshots or changelogs if you need trends, cycle time, or time in status.
Treating every edit or message as meaningful activity.→ Define qualifying activity and exclude automated, test, and low-signal events.
Using one freshness window for every content type.→ Policies, project plans, templates, and archives age at different rates.
Turning contributor counts into a performance ranking.→ Use activity to find coverage and ownership gaps, not to rank people.
Building dashboards from live MCP lookups only.→ MCP is useful for exploration; durable dashboards need a database-backed model.

Related analytics

Related integrations

FAQ

Does Metabase connect natively to Microsoft Teams?
No. Metabase reads databases and warehouses. Sync Microsoft Teams into a database first, or upload a CSV with the Metabase CLI, then build Metabase models and dashboards on top.
Is the Microsoft Teams MCP route enough for dashboards?
Use MCP for live exploration and quick exports. For dashboards people depend on, sync the data into a database or warehouse so you keep history, refresh schedules, permissions, and a governed model layer.
What counts as fresh content?
Set a review window by content class, then measure documentation freshness from the last meaningful review or update. A 90-day default is useful for operational content, but policies and archives need different windows.
Does activity prove that content is useful?
No. Workspace activity shows use and change, not quality. Pair it with ownership, freshness, coverage, search, and support-deflection evidence where available.