metabase-query

Execute native SQL queries against Metabase databases and fetch results.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/tecnologia-ibtech/geo-codex --skill metabase-query
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: metabase-query
Source: https://github.com/tecnologia-ibtech/geo-codex/tree/main/geo-metabase/skills/metabase-query
Command: npx skills add https://github.com/tecnologia-ibtech/geo-codex --skill metabase-query

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables programmatic execution of native SQL queries against Metabase-connected databases, streamlining data access and ad-hoc analysis.

Core Features & Use Cases

  • Native SQL execution against Metabase databases via the API.
  • Safe query execution with safeguards (e.g., LIMIT) and clear result formatting.
  • Use Case: When investigating data issues or performing quick data extraction for reports.

Quick Start

Run a native SQL query against a Metabase database and return results in a readable table.

Frequently Asked Questions about metabase-query

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run native SQL queries against a Metabase database programmatically?

You can run native SQL queries against a Metabase database programmatically by using an API interface that executes your SQL statements and fetches results. This streamlines ad-hoc data analysis and extraction directly through the Metabase API.

Do I need an API key to extract data from Metabase databases?

Yes, extracting data from Metabase databases requires a METABASE_API_KEY environment variable. You also need to specify the target database ID to execute native SQL queries and retrieve your data analysis results successfully.

What is the best way to investigate data issues using Metabase SQL?

The best way to investigate data issues using Metabase SQL is by executing native queries through an API that includes built-in safeguards like LIMIT clauses. This ensures safe, quick data extraction and returns markdown-formatted results for clear analysis.

Can I use native SQL for ad-hoc data analysis across Metabase-connected databases?

Yes, you can use native SQL for ad-hoc data analysis across Metabase-connected databases. By querying programmatically via the Metabase API, you can investigate data issues and extract quick reports with readable, markdown-formatted output.

Are there any safeguards when running native SQL data extraction queries in Metabase?

Yes, executing native SQL data extraction queries in Metabase includes safeguards such as a LIMIT clause to prevent excessive data retrieval. Results are also returned in a clear, markdown-formatted table to ensure safe and readable output.