Skip to main content

Metabase

Prefer guided AI setup?

Instead of following these steps manually, you can use the AI Credential Assistant — describe what you want to connect and the AI will walk you through the setup step by step, tailored to your account.

Overview​

Connect your Metabase instance to Nirvai to access dashboards, run queries, and automate analytics workflows. Metabase is an open-source business intelligence tool that makes it easy to visualize and share data insights.

Supported Authentication Methods​

  • Basic Auth (Username + Password) + Host URL - Required

Prerequisites​

  • Access to a Metabase instance (self-hosted or cloud)
  • A Metabase user account with appropriate permissions

Setup Instructions​

Step 1: Access Your Metabase Instance​

  1. Note your Metabase instance URL (e.g., https://your-metabase.com)
  2. Ensure you have login credentials for the instance

Step 2: Gather Your Credentials​

  1. Your Metabase username (usually your email)
  2. Your Metabase password
  3. The base URL of your Metabase instance

Step 3: Add to Nirvai​

  1. In Nirvai, create a new Metabase credential
  2. Enter the Metabase instance URL
  3. Enter your username (email)
  4. Enter your password
  5. Save the credential

Important Notes​

  • Session-based auth: Metabase API uses session tokens internally
  • User permissions: API access follows your user's permissions
  • Custom domains: If using a custom domain, use that URL
  • Self-hosted: Ensure the instance is accessible from Nirvai

Features​

Metabase API enables:

  • Dashboards: Access and export dashboards
  • Questions: Run saved questions (queries)
  • Cards: Manage visualization cards
  • Databases: List connected databases
  • Collections: Organize content

User Permissions​

The API inherits permissions from your user account:

  • Viewer: Can view dashboards and run queries
  • Editor: Can create and modify content
  • Admin: Full access including settings

Troubleshooting​

Login Failed​

  • Verify username and password are correct
  • Check if your account is active
  • Ensure the instance URL is correct

Cannot Access Certain Dashboards​

  • Verify your user has access to those dashboards
  • Check collection permissions
  • Contact your Metabase administrator

Connection Timeout​

  • Verify the Metabase instance is running
  • Check network connectivity
  • Ensure the URL is accessible from external sources

SSL Certificate Errors​

  • For self-hosted instances, verify SSL configuration
  • Ensure the certificate is valid and trusted

Documentation adapted for Nirvai platform

Next Steps​

Got your credential? Connect it to an agent

Use the AI Tool Creator to turn this credential into agent-callable tools. Describe what your agent should be able to do and the AI investigates the API, configures the endpoints, and gives you a reviewable toolkit before saving anything.