Skip to content
dinobase

Claude Desktop

Dinobase integrates with Claude Desktop via MCP. Once connected, Claude can query all your synced business data through natural conversation.

Install

Section titled “Install”
Terminal window
curl -fsSL https://dinobase.ai/install.sh | bash -s -- claude-desktop

Installs Dinobase via uv, runs dinobase init, and writes the mcpServers entry to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS). Then connect your data sources:

Terminal window
dinobase add stripe --api-key sk_test_...
dinobase add hubspot --api-key pat-...
dinobase sync

See Connecting Sources for the full list of 100+ supported sources, and Syncing & Scheduling for background sync options.

To re-run the setup step: dinobase install claude-desktop (safe to run multiple times — merges rather than overwrites).

With background sync

Section titled “With background sync”

Keep data fresh while Claude Desktop is running:

{
  "mcpServers": {
    "dinobase": {
      "command": "dinobase",
      "args": ["serve", "--sync", "--sync-interval", "30m"]
    }
  }
}

How it works

Section titled “How it works”

When Claude Desktop connects, it sees dynamic instructions computed from your actual database state — which sources are connected, what tables exist, and how many rows are loaded. Claude will:

  1. Call list_sources to discover available data
  2. Call describe on relevant tables to understand columns and types
  3. Write and execute SQL via query
  4. For mutations (UPDATE/INSERT), query returns a preview — Claude calls confirm to execute

Available tools

Section titled “Available tools”

The MCP server exposes these tools to Claude:

ToolDescription
queryExecute SQL queries (DuckDB dialect)
describeGet table schema, column types, and sample data
list_sourcesList all connected sources with row counts and freshness
refreshRe-sync a data source to get fresh data
confirmExecute a pending mutation (write-back to source API)
confirm_batchExecute multiple pending mutations
cancelCancel a pending mutation

Next steps

Section titled “Next steps”