Gorgias × Metabase

How to build Gorgias support dashboards in Metabase

Gorgias is the help desk built for ecommerce, tying customer tickets to orders from Shopify and other stores. Metabase is where you turn that activity into shared, trustworthy dashboards. This guide covers two complementary paths: a lightweight MCP + CLI route that pulls live data with the Gorgias MCP server and loads a CSV into Metabase with the Metabase CLI for quick analysis, and a durable pipeline route that syncs Gorgias 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 Gorgias connector. For dashboards that need history and reliability, you'll sync Gorgias into a database first (covered below).

How do you connect Gorgias to Metabase?

Most teams combine both routes: use the Gorgias MCP server and Metabase CLI route to pull live data and stand up a quick analysis, and the pipeline route for the dashboards people depend on.

1 · MCP + CLI route (AI-assisted)

Live data in, quick analysis out

Pair Gorgias's official MCP server (to read live ticket and customer data) with the Metabase CLI, whose upload command loads a CSV into Metabase as a ready-to-query table and model.

Best for
  • Voice-of-customer questions like "top return drivers this week?"
  • Loading a Gorgias CSV export into Metabase in seconds
  • Spot-checks and one-off analyses without a warehouse
Trade-offs
  • Great for exploration, not governed reporting
  • Gorgias's MCP is in open beta — reads are live, some writes gated; keep analysis read-only
  • CSV uploads are snapshots — refresh or move to the pipeline for history
2 · Pipeline route (warehouse-backed)

Durable dashboards with history

Sync Gorgias into a database or warehouse with dlt or the REST API, then point Metabase at it.

Best for
  • Support-driven revenue and response-time dashboards
  • Joining tickets with Shopify orders and customers
  • Trends over quarters and peak-season comparisons
Trade-offs
  • No first-party managed connector — plan on API or dlt-based sync
  • You own the data model and refresh schedule
  • Capture ticket events for accurate time-in-status

What can you analyze from Gorgias data in Metabase?

  • Ticket volume — created vs. closed by day and channel
  • First response time — especially during sales peaks
  • Support-driven revenue — orders and conversions linked to support
  • Return and refund drivers — top contact reasons by tag
  • Backlog and aging — open work and how long it's been waiting
  • CSAT — satisfaction surveys over time
  • Repeat contacts — customers writing in again and again

Which Gorgias dashboards should you build in Metabase?

For: CX leads

Support overview

The daily pulse of volume and responsiveness.

  • Tickets created vs. closed per day (dual line)
  • Median first response time (number + trend)
  • Open backlog by status (bar)
  • Volume by channel (email, chat, social) (bar)
For: Ecommerce ops

Support-driven revenue

Tie support activity to orders, Gorgias's signature angle.

  • Revenue from support-influenced conversations (number)
  • Tickets linked to orders (number + %)
  • Top return / refund drivers by tag (bar)
  • Conversion after a support interaction (table)
For: Support ops

Response time & SLA

Are we replying fast enough during peaks?

  • First response time p50/p90 by week (line)
  • Aging open tickets by days-open bucket (table)
  • Volume by hour of day (heatmap-style bar)
  • Reopened tickets by week (line)
For: CX leadership

CSAT & drivers

Track satisfaction and what's generating contacts.

  • CSAT % by week (line)
  • Bad ratings by tag (bar)
  • Volume by tag/topic (bar)
  • Repeat-contact customers (table)

How do you use the Gorgias MCP server with the Metabase CLI?

Pair the Gorgias MCP server with the Metabase CLI for fast, hands-on analysis. Gorgias hosts a first-party MCP server (open beta) that reads live ticket and customer data; the Metabase CLI's upload command loads a CSV into Metabase and creates a ready-to-query table and model. For analysis, keep the Gorgias MCP read-only.

Example workflow

  • Ask the Gorgias MCP for the top return drivers and most-requested restocks this week.
  • Export the tickets, messages, and customers you want to keep as CSVs.
  • Run mb upload csv to load them into Metabase as tables and models, then build questions and dashboards on top.

Be honest about the limits

  • The Gorgias MCP is great for live lookups — not for scheduled or audited reporting.
  • A CSV upload is a point-in-time snapshot; trend and time-in-status analysis still needs a warehouse sync, or refresh with mb upload replace.
  • Reads are live in the beta; some write actions are gated — keep analysis read-only.
  • mb upload csv needs an uploads database configured under Admin → Settings → Uploads.

How do you set up the Gorgias MCP server and the Metabase CLI?

Gorgias MCPofficial

Endpoint
https://mcp.gorgias.com/mcp?gorgias_subdomain=YOUR-SUBDOMAIN
Transport
Remote (Streamable HTTP)
Auth
OAuth (log in to your Gorgias account)
Note
Available on paid plans; reads live, some writes gated.

Metabase CLIofficial

Install
npm install -g @metabase/cli
Auth
mb auth login (browser OAuth on v62+, or an API key)
Load data
mb upload csv --file data.csv
Requires
An uploads database (Admin → Settings → Uploads)
Cursor~/.cursor/mcp.json or .cursor/mcp.json
{
  "mcpServers": {
    "gorgias": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.gorgias.com/mcp?gorgias_subdomain=YOUR-SUBDOMAIN"
      ]
    }
  }
}

Replace YOUR-SUBDOMAIN with the part of your Gorgias URL before.gorgias.com. On first connection the server opens a browser window to authorize.

TerminalLoad a Gorgias 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 Gorgias CSV export — creates a table AND a model
mb upload csv --file gorgias-tickets.csv --collection root

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

The Metabase CLI stores its credentials securely after mb auth login. Keep the Gorgias MCP read-only so analysis can't trigger gated writes.

Verify before shipping: confirm an uploads database is enabled under Admin → Settings → Uploads (Metabase docs) and the current Gorgias MCP setup in the Gorgias docs.

Can you generate a Gorgias dashboard with AI?

Yes. Use the prompt below with any assistant that can run the Gorgias MCP server and the Metabase CLI. It works end to end: if Gorgias tables already exist in Metabase it analyzes those; otherwise it pulls the data over the Gorgias MCP, loads it with mb upload csv, then builds the dashboard — using medians for response times and skipping cards it has no data for, including support-driven revenue if no order data is present.

Prompt for creating a Gorgias Support Overview dashboard
Create a polished Metabase dashboard for Gorgias ecommerce support analytics.
Work end to end: get the data into Metabase if it isn't there yet, then build.

Goal: Help ecommerce CX leaders understand volume, responsiveness, support-driven
revenue, CSAT, and contact drivers from Gorgias data.

Step 1 — Find or load the data:
- First, check what already exists in Metabase (search for Gorgias tables and
  models). If durable Gorgias data is already present — synced from a warehouse or
  uploaded earlier — use it and skip to Step 2.
- If nothing is there, pull it with the Gorgias MCP server (keep it read-only):
  tickets, messages, customers, users (agents), tags, and satisfaction surveys.
  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 names. Map the available raw tables into these
analytical concepts where possible: Tickets, Messages, Customers, Users (agents),
Tags, Satisfaction surveys, and any linked order/revenue data (e.g. Shopify) if
present. Inspect the actual tables and column names first.

Important:
- Build on whatever data is present; don't claim Metabase connects natively to
  Gorgias — it reads a database or CLI-uploaded tables.
- Use medians (p50) and p90 for response times, never averages.
- Define "first response" as the first outbound agent message, excluding internal
  notes and automated messages.
- Only build support-driven revenue cards if linked order data is actually present.
- If ticket event history is missing, do not calculate reopen rate or
  time-in-status. Use a caveat instead.
- Only build a card if its underlying column/metric exists in the data.
- A single CSV is a point-in-time snapshot: reopen rate and time-in-status need
  history, so build trend cards only if a warehouse sync or multiple uploads
  provide it.

Dashboard title: Gorgias Support Overview

Sections:
1. Executive summary (KPI cards): Tickets created last 7 days; Closed last 7 days;
   Open backlog; Median first response time; CSAT % (only if survey data exists);
   Support-influenced revenue (only if order data exists).
2. Volume & backlog: Created vs closed by day; Open by status; Backlog aging;
   Volume by channel.
3. Support-driven revenue: Tickets linked to orders; Top return drivers by tag;
   Conversion after support (only if order data exists).
4. Response time: First response p50/p90 by week; Volume by hour; Reopened by week.
5. CSAT & drivers: CSAT by week; Bad ratings by tag; Volume by tag; Repeat
   contacts.

Filters: Channel, Tag, Agent, Status, Date range.

Reuse the models Metabase auto-created from uploaded CSVs, or (for a warehouse)
create reusable models: modeled_gorgias_tickets, modeled_gorgias_messages,
modeled_gorgias_customers, modeled_gorgias_users, and
modeled_gorgias_satisfaction.

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. Keep it practical, dense,
and executive-readable. Avoid vanity metrics.

How do you build the Gorgias → Metabase pipeline?

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

No paid tool required. A fully free stack: a small dlt or hand-written script (extract) → a free Postgres database like Neon or Supabase (load) → a scheduler such as GitHub Actions cron (host) → Metabase (visualize). For hosting and scheduling details, see our data pipeline guide.

Connector options

  • dlt (free, code) — write a Python pipeline against the Gorgias REST API; the most reliable route since there's no first-party managed connector.
  • Gorgias REST API (free, raw) — the source of truth; paginate tickets, messages, customers, and events and upsert on a schedule.
  • Managed ETL (paid, verify) — check whether your ETL vendor offers a Gorgias connector; availability varies, so confirm before relying on it.
  • Store data — sync your ecommerce platform (e.g. Shopify) alongside Gorgias so you can join tickets to orders.

Notes

  • Land raw tables first, then build clean models on top.
  • Capture ticket events if you want accurate reopen rate and time-in-status.
  • Join on customer email or external order IDs to connect support with revenue.

How should you model Gorgias data in Metabase?

Core tables

TableGrainKey columns
ticketsone row per ticketid, status, channel, assignee_user_id, customer_id, created_datetime, closed_datetime
messagesone row per messageticket_id, from_agent, is_internal_note, created_datetime
customersone row per customerid, email, name
usersone row per agentid, name
satisfaction_surveysone row per surveyticket_id, score, created_datetime

Modeling advice

  • Define first response from the first from_agent = true, non-internal message.
  • Normalize status (open/closed) and channel so charts stay stable.
  • Join tickets to your store's orders on customer email or order reference to model support-driven revenue honestly.
  • Treat tags as a bridge table so a ticket can carry many tags.
  • Define "closed" once and reuse it everywhere.

Which Gorgias metrics should you track in Metabase?

MetricDefinitionNotes
First response timeCreated → first agent message.Report median and p90; watch it during sales peaks.
Ticket volumeCreated vs. closed in a period.Segment by channel; expect seasonality.
Support-driven revenueRevenue from orders linked to support interactions.Only meaningful with joined order data.
CSATPositive surveys ÷ rated tickets.Watch the response rate too.
BacklogOpen tickets right now.Pair with aging buckets.
Repeat-contact rateCustomers with multiple tickets.A signal of unresolved root causes.

What SQL powers Gorgias dashboards in Metabase?

These assume the modeled tables above (PostgreSQL dialect). Adjust identifiers to match your warehouse.

Tickets created vs. closed per dayPostgreSQL

The basic volume trend over the last 30 days.

SELECT
  date_trunc('day', t.created_datetime) AS day,
  COUNT(*)                                          AS created,
  COUNT(*) FILTER (WHERE t.status = 'closed')       AS closed
FROM tickets t
WHERE t.created_datetime >= CURRENT_DATE - INTERVAL '30 days'
GROUP BY 1
ORDER BY 1;
First response time by weekPostgreSQL

Median from the first outbound agent message per ticket.

WITH first_outbound AS (
  SELECT
    m.ticket_id,
    MIN(m.created_datetime) AS first_reply_at
  FROM messages m
  WHERE m.from_agent = true
    AND m.is_internal_note = false
  GROUP BY m.ticket_id
)
SELECT
  date_trunc('week', t.created_datetime) AS week,
  percentile_cont(0.5) WITHIN GROUP (
    ORDER BY EXTRACT(EPOCH FROM (f.first_reply_at - t.created_datetime)) / 60.0
  ) AS median_first_reply_min
FROM tickets t
JOIN first_outbound f ON f.ticket_id = t.id
GROUP BY 1
ORDER BY 1;
Volume by tagPostgreSQL

Top contact drivers — returns, shipping, product — over 90 days.

SELECT
  tg.name            AS tag,
  COUNT(*)           AS tickets
FROM tickets t
JOIN ticket_tags tt ON tt.ticket_id = t.id
JOIN tags tg ON tg.id = tt.tag_id
WHERE t.created_datetime >= CURRENT_DATE - INTERVAL '90 days'
GROUP BY tg.name
ORDER BY tickets DESC
LIMIT 20;
Repeat-contact customersPostgreSQL

Customers who wrote in three or more times in the last 90 days.

SELECT
  c.email,
  COUNT(*)           AS ticket_count
FROM tickets t
JOIN customers c ON c.id = t.customer_id
WHERE t.created_datetime >= CURRENT_DATE - INTERVAL '90 days'
GROUP BY c.email
HAVING COUNT(*) >= 3
ORDER BY ticket_count DESC
LIMIT 50;

What are common mistakes when analyzing Gorgias in Metabase?

Treating a live MCP lookup or a one-off CSV as governed reporting.→ Use the Gorgias MCP and CSV uploads for voice-of-customer exploration; build warehouse-backed dashboards for anything people depend on.
Claiming support-driven revenue without order data.→ Only build revenue cards once you've joined Gorgias tickets to store orders.
Counting internal notes or automations as first response.→ Restrict to outbound agent messages.
Using averages for response time.→ Report medians and p90 — response time spikes hard during sales events.
Ignoring seasonality.→ Compare like periods (e.g. this Black Friday vs. last) rather than week-over-week.

Related analytics

Related integrations

FAQ

Does Metabase connect natively to Gorgias?
No. Metabase reads SQL databases and warehouses. Sync Gorgias into a database first (dlt or the REST API), then connect Metabase to that database.
Is the Gorgias MCP server official?
Yes. Gorgias hosts a first-party MCP server (open beta) at mcp.gorgias.com/mcp with a gorgias_subdomain query parameter, authenticated via OAuth. Reads are live; some write actions are gated during the beta.
How do I quickly analyze Gorgias data without a warehouse?
Pull the tickets, messages, and customers you need with the Gorgias MCP server (keep it read-only), export them to CSV, and run `mb upload csv --file data.csv` with the Metabase CLI. It creates a table and a model you can build questions on right away. You'll need an uploads database enabled under Admin → Settings → Uploads. Refresh later with `mb upload replace`, or move to the pipeline route when you need history.
Do I need a paid connector to sync Gorgias?
No. Gorgias has no first-party managed connector, so a free stack is the natural fit: a small dlt or hand-written script against the Gorgias REST API, a free Postgres tier (Neon or Supabase), and GitHub Actions cron to run it on a schedule.
How do I measure support-driven revenue?
Sync your store (e.g. Shopify) alongside Gorgias and join tickets to orders on customer email or order reference. Only then can you attribute revenue to support interactions honestly.