Confluence × Metabase

How to build Confluence dashboards in Metabase

Confluence is a team knowledge base for spaces, pages, comments, decisions, and long-lived documentation. 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 Atlassian Rovo MCP Server and loads a CSV into Metabase with the Metabase CLI, and a durable pipeline route that syncs Confluence 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 Confluence connector. For dashboards that need history and reliability, sync Confluence into a database first.

How do you connect Confluence 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 Atlassian Rovo 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 knowledge-base freshness by space"
  • Loading a Confluence 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 Confluence into a database or warehouse with a managed connector, custom pipeline, or API, then point Metabase at it.

Best for
  • Confluence dashboards leaders depend on
  • Joining Confluence data with product, support, sales, or engineering data
  • Long-run trends for knowledge-base freshness by space and coverage and ownership gaps
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 Confluence data in Metabase?

  • Knowledge-base freshness by space — built from pages and the related spaces, page versions, comments data your sync exposes.
  • Coverage and ownership gaps — built from pages and the related spaces, page versions, comments data your sync exposes.
  • Stale high-traffic pages — built from pages and the related spaces, page versions, comments data your sync exposes.
  • Page creation and update activity — built from pages and the related spaces, page versions, comments data your sync exposes.
  • Comment and contributor activity — built from pages and the related spaces, page versions, comments data your sync exposes.

Which Confluence dashboards should you build in Metabase?

For: Operations and program owners

Confluence overview

The shared operating view to build first.

  • Knowledge-base freshness by space
  • Coverage and ownership gaps
  • Stale high-traffic pages
For: Content and workspace owners

Coverage, freshness, and activity

The deeper views that expose risk and cleanup work.

  • Page creation and update activity
  • Comment and contributor activity

How do you use the Atlassian Rovo MCP Server with the Metabase CLI?

Pair the Atlassian Rovo 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 recently updated, stale, or ownerless pages.
  • 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.
  • Change events or snapshots are required for reliable freshness and activity trends.
  • mb upload csv needs an uploads database configured under Admin → Settings → Uploads.

How do you set up Confluence MCP and the Metabase CLI?

Atlassian Rovo MCP Serverofficial

Transport
Hosted remote MCP via Streamable HTTP
Auth
OAuth 2.1 or an Atlassian API token for supported headless clients
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": {
    "atlassian": {
      "url": "https://mcp.atlassian.com/v1/mcp/authv2"
    }
  }
}
TerminalLoad a Confluence 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 pages export — creates a table AND a model
mb upload csv --file confluence-pages.csv --collection root

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

Can you generate a Confluence dashboard with AI?

Yes. Use the prompt below with any assistant that can run the Atlassian Rovo MCP Server and the Metabase CLI. It works end to end: if Confluence 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 Confluence Content & Knowledge Overview dashboard
Create a polished Metabase dashboard for Confluence content & knowledge 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 content freshness, ownership, knowledge coverage, workspace activity, and stale-content risk from Confluence data.

Step 1 — Find or load the data:
- First, check what already exists in Metabase (search for confluence tables and
  models). If durable Confluence 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 Atlassian Rovo MCP Server: pages,
  spaces, page versions, comments. 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
  Confluence — 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: Confluence Content & Knowledge Overview

Sections:
1. Executive summary: Total active content; Freshness rate; Owned-content rate;
   Content updated last 30 days; Stale high-priority content.
2. Freshness: Content by age bucket; stale content by workspace/container and owner.
3. Coverage: Missing owners, descriptions, classifications, or required topic coverage.
4. Activity: Created vs updated by week; active contributors and containers.
5. Governance: External sharing, orphaned content, and permission risk when available.

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 Confluence data into a database or warehouse?

For dashboards that need history and reliability, land Confluence 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 Confluence Cloud REST API for control over fields, history, and refresh cadence.
  • MCP + CSV — use this for quick exploration and one-off slices.

Sync spaces, pages, versions, comments, labels, and owners with the Confluence REST API or a managed connector; keep page versions or snapshots for freshness trends.

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 owner, container, content type, lifecycle, created, updated, and reviewed-date fields.

How should you model Confluence data in Metabase?

Core tables

TableGrainKey columns
confluence_pagesone row per pagepage_id, space_id, title, owner_id, status, created_at, updated_at, version_number
confluence_spacesone row per spacespace_id, key, name, type, status, homepage_id
confluence_page_versionsone row per page versionpage_id, version_number, author_id, created_at, message

Modeling advice

  • Build a clean content_items 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 Confluence metrics should you track in Metabase?

MetricDefinitionNotes
Documentation freshnessActive content updated inside an agreed freshness window.Set different windows by content class.
Knowledge-base coverageRequired topics or objects with current, owned documentation.Define the required inventory first.
Workspace activity rateActive containers ÷ eligible containers in a period.Separate healthy quiet from abandoned.

What SQL powers Confluence dashboards in Metabase?

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

Content freshness by containerPostgreSQL

The share of active content updated in the last 90 days.

SELECT
  container_name,
  COUNT(*) AS content_items,
  COUNT(*) FILTER (
    WHERE updated_at >= CURRENT_DATE - INTERVAL '90 days'
  ) AS fresh_items,
  ROUND(
    100.0 * COUNT(*) FILTER (
      WHERE updated_at >= CURRENT_DATE - INTERVAL '90 days'
    ) / NULLIF(COUNT(*), 0),
    2
  ) AS freshness_rate
FROM content_items
WHERE archived_at IS NULL
GROUP BY container_name
ORDER BY freshness_rate ASC;
Ownership coveragePostgreSQL

Active content with an accountable owner.

SELECT
  container_name,
  COUNT(*) AS content_items,
  COUNT(*) FILTER (WHERE owner_id IS NOT NULL) AS owned_items,
  ROUND(
    100.0 * COUNT(*) FILTER (WHERE owner_id IS NOT NULL)
    / NULLIF(COUNT(*), 0),
    2
  ) AS ownership_coverage
FROM content_items
WHERE archived_at IS NULL
GROUP BY container_name
ORDER BY ownership_coverage ASC;
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;

What are common mistakes when analyzing Confluence 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 Confluence?
No. Metabase reads databases and warehouses. Sync Confluence into a database first, or upload a CSV with the Metabase CLI, then build Metabase models and dashboards on top.
Is the Confluence 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.