Guide - Integrations

How do you analyze Ramp spend data in Metabase?

Ramp analytics turns finance operations into shared, queryable models. Ramp manages corporate cards, expenses, reimbursements, bills, vendors, spend programs, and accounting coding. In Metabase, Ramp data becomes a finance-operations layer for spend visibility, policy exceptions, budget ownership, and close readiness. Metabase connects to the database that holds the synced data; it does not connect natively to Ramp.

TL;DR - Use the MCP + CLI route for a scoped, short-lived analysis. Use the official API or approved connector route for recurring dashboards, history, permissions, and reconciliation.

How do you connect Ramp to Metabase?

1 - MCP + CLI route (AI-assisted)

Explore a scoped snapshot quickly

Ramp hosts an official OAuth-enabled remote MCP for querying business data and taking permitted actions. Use the authenticated user's least-privilege Ramp role and keep durable reporting on the API pipeline. Pair the approved server with the Metabase CLI to load a focused CSV as a table and model.

Best for
  • Quick questions about Ramp data
  • Validating fields and dashboard ideas before building a pipeline
  • Loading a minimal, permissioned snapshot into Metabase
Trade-offs
  • A CSV is a point-in-time snapshot, not governed reporting
  • Finance data needs least-privilege credentials and an explicit tool allowlist
  • Move recurring dashboards to the warehouse-backed route
2 - Pipeline route (warehouse-backed)

Durable dashboards with history

Use Ramp's developer API or an approved connector to sync transactions, cards, users, departments, vendors, bills, reimbursements, and accounting fields. Retain lifecycle and review status instead of exporting only settled spend.

Best for
  • Recurring finance and leadership dashboards
  • Historical aging, lifecycle, and period reporting
  • Joining finance data with sales, product, and operations data
Trade-offs
  • Requires a destination database and maintained sync
  • You own currency, status, accounting period, and reconciliation definitions
  • Every modeled total should reconcile to the source system

What can you analyze from Ramp?

  • Spend by department, vendor, category, and program
  • Budget utilization and forecast
  • Policy exceptions and missing receipts
  • Bill and reimbursement cycle time
  • Accounting coding and ERP-sync readiness

Which Ramp dashboards should you build in Metabase?

For: Finance leaders

Finance overview

A compact view of cash, exposure, and operating performance.

  • Month-to-date spend
  • Spend vs. budget
  • Top vendors
  • Card, bill, and reimbursement mix
For: Finance operations

Operations

The work that needs attention before the next close.

  • Transactions awaiting review
  • Missing receipts
  • Bills due
  • Reimbursements awaiting approval
For: Controllers

Controls and reconciliation

Find exceptions before they become close surprises.

  • Out-of-policy transactions
  • Missing GL or department coding
  • Duplicate vendor candidates
  • ERP sync failures
For: FP&A

Planning and trends

Compare actuals with the plan and explain the variance.

  • Department run rate
  • Vendor renewal exposure
  • Committed vs. actual spend
  • Savings and consolidation opportunities

How do you use Ramp MCP with the Metabase CLI?

The Ramp MCP is a officialMCP option for AI-assisted exploration. Ramp hosts an official OAuth-enabled remote MCP for querying business data and taking permitted actions. Use the authenticated user's least-privilege Ramp role and keep durable reporting on the API pipeline. The Metabase CLI can then upload a sanitized CSV and create a ready-to-query table and model.

  • Start with a narrow read-only question and the minimum required objects.
  • Remove secrets, bank details, and personal fields before exporting.
  • Use mb upload csv for a first snapshot and mb upload replace for a controlled refresh.
  • Move to an API or connector sync when the dashboard becomes recurring.

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

Ramp MCPofficial

Data source
Ramp API
Auth
Ramp OAuth or API credentials with read-only spend scopes
Access
Read-only, least privilege
Use for
Exploration and scoped exports

Metabase CLIofficial

Install
npm install -g @metabase/cli
Auth
mb auth login
Load data
mb upload csv --file data.csv
Requires
An uploads database in Metabase
MCP clientExample MCP configuration - verify before use
{
  "mcpServers": {
    "ramp": {
      "type": "http",
      "url": "https://mcp.ramp.com/mcp"
    }
  }
}
TerminalLoad a Ramp 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 scoped Ramp export - creates a table and a model
mb upload csv --file ramp-export.csv --collection "Finance & Accounting"

# Refresh the same table later
mb upload replace <table-id> --file ramp-export.csv
Verify before connecting: check the current Ramp MCP documentation, review every MCP tool, and enable an uploads database under Admin > Settings > Uploads. Use the vendor's documented authentication flow and a least-privilege role for analytics.

Can you generate a Ramp finance dashboard with AI?

Yes. Use the prompt below with an assistant that can access an approved data route and the Metabase CLI. It tells the assistant to inspect the real schema, reconcile totals, and skip cards that the available data cannot support.

Prompt for a Ramp finance dashboard
Create a polished Metabase dashboard for Ramp finance analytics.
Work end to end: find existing modeled data first; if none exists, load a minimal
read-only snapshot or describe the warehouse sync required.

Goal: Connect Ramp to Metabase for card spend, bills, reimbursements, vendor concentration, policy compliance, and accounting-close dashboards.

Inspect before querying:
- Inspect actual tables, column names, currencies, status values, and timestamps.
- Do not assume the source schema matches this guide exactly.
- Reconcile source totals before publishing any finance KPI.

Important:
- Do not claim Metabase connects natively to Ramp; it reads a
  supported database or CLI-uploaded tables.
- Keep native amount, native currency, and reporting-currency amount separate.
- Distinguish authorization, posting, payment, settlement, and reconciliation
  states where the source exposes them.
- Use stable business keys and apply updates/deletes during incremental syncs.
- Exclude account numbers, personal data, and secrets from broad dashboards.
- Only build cards whose required fields and history are actually present.

Dashboard sections:
1. Finance overview: Month-to-date spend; Spend vs. budget; Top vendors; Card, bill, and reimbursement mix.
2. Operations: Transactions awaiting review; Missing receipts; Bills due; Reimbursements awaiting approval.
3. Controls and reconciliation: Out-of-policy transactions; Missing GL or department coding; Duplicate vendor candidates; ERP sync failures.
4. Planning and trends: Department run rate; Vendor renewal exposure; Committed vs. actual spend; Savings and consolidation opportunities.

Suggested models: modeled_ramp_spend, modeled_ramp_policy_exceptions, modeled_ramp_bills, modeled_ramp_budget_actuals.

Output: Build the dashboard if you have permission; otherwise provide the exact
questions, SQL, model definitions, and layout. State refresh time, reporting
currency, accounting basis, and any reconciliation caveats.

How do you sync Ramp into a database or warehouse?

Use Ramp's developer API or an approved connector to sync transactions, cards, users, departments, vendors, bills, reimbursements, and accounting fields. Retain lifecycle and review status instead of exporting only settled spend.

Ramp API or data service

Start from Ramp's official interface and authentication documentation. Extract only the finance objects required by the models below.

Custom dlt REST API pipeline

Configure dlt from Ramp's official developer schema for a Python-owned pipeline and selectable warehouse destination.

Implementation checklist

  1. Create a dedicated read-only integration identity and document its scopes.
  2. Land raw records with source IDs, source timestamps, extraction time, and currency fields intact.
  3. Apply updates and deletes idempotently; keep lifecycle history when aging or process metrics depend on it.
  4. Reconcile modeled totals to Ramp for a closed period before exposing the models broadly.
  5. Connect Metabase to the destination database and schedule model refreshes.

Source documentation

What data model should you use?

EntityGrainUse
transactionsone row per card transactionmerchant, amount, coding, and review status
billsone row per vendor billAP workflow and due dates
reimbursementsone row per reimbursementemployee spend workflow
users_departmentsone row per user assignmentbudget ownership and allocation
vendorsone row per normalized vendorconcentration and renewal analysis

Build reusable models such as modeled_ramp_spend, modeled_ramp_policy_exceptions, modeled_ramp_bills, modeled_ramp_budget_actuals.

Which finance metrics are useful?

Practical SQL patterns

Monthly spend by departmentPostgreSQL
SELECT
  date_trunc('month', transaction_date) AS month,
  department_name,
  SUM(amount) AS spend
FROM modeled_ramp_spend
WHERE transaction_state = 'CLEARED'
GROUP BY 1, 2
ORDER BY 1, 3 DESC;
Cleared spend missing close controlsPostgreSQL

Turn uncoded transactions and missing receipts into a finance operations queue.

SELECT
  department_name,
  COUNT(*) AS transactions_to_review,
  SUM(amount) AS spend_to_review
FROM modeled_ramp_spend
WHERE transaction_state = 'CLEARED'
  AND (gl_account_id IS NULL OR receipt_status <> 'RECEIVED')
GROUP BY 1
ORDER BY spend_to_review DESC;

Common mistakes

Counting authorizations and cleared transactions as separate spend.→ Model the transaction lifecycle and report one settled record per purchase.
Using merchant strings as clean vendors.→ Normalize vendor identities before concentration or contract analysis.
Hiding uncoded transactions from finance dashboards.→ Surface missing GL, department, and receipt fields as close-readiness metrics.

Dashboards

Integrations

Analytics

FAQ

Can Ramp data replace ERP actuals?
Use Ramp for spend operations and coding status, then reconcile cleared and exported records to the ERP ledger.
Which Ramp records matter for close readiness?
Transactions, bills, reimbursements, coding fields, receipts, approvals, and ERP sync status.
Does Metabase connect natively to Ramp?
No. Metabase reads supported databases and uploaded tables. Sync Ramp data into a database or load a scoped CSV snapshot first.