SQL Runner

SQL Runner skill enables your Claude agent to query and manipulate databases using natural language that gets translated into SQL and executed safely. Supports PostgreSQL, MySQL, MariaDB, and SQLite — configure one or multiple database connections, each with its own credentials and connection pool settings.

Safety-first design: by default the skill operates in read-only mode, executing only SELECT queries. Write mode (INSERT, UPDATE, DELETE, DDL) must be explicitly enabled per connection and supports a preview mode that shows the generated SQL and affected row count estimate before executing. This prevents accidental data modification from misunderstood natural language instructions.

Schema introspection automatically maps your database structure — tables, columns, data types, foreign keys, and indexes — giving the agent full context to generate accurate queries without you describing the schema. For large databases with hundreds of tables, the skill uses semantic search to find relevant tables based on your question topic.

Query result formatting adapts to use case: Markdown tables for display in chat, CSV for export, JSON for downstream processing, or summary statistics (count, min, max, average) for quick analysis. Long-running queries have configurable timeouts with graceful cancellation. Parameterized queries prevent SQL injection when user-provided values are incorporated into queries. Data analysts, backend developers, and business intelligence users rely on SQL Runner to make database exploration conversational — no SQL expertise required for common queries, and expert-level SQL available on demand for complex analytics.

Installation

clawhub install sql-runner

Install: clawhub install sql-runner