Skip to content

gemini-cli-extensions/cloud-sql-mysql

claude-code

Skills for Cloud SQL for MySQL

cloud-sql-mysql is an open-source agent skill set by Google that lets AI coding agents manage Cloud SQL for MySQL databases using natural language. Provision, query, back up, and monitor instances without leaving Claude Code, Gemini CLI, or Codex.

11 stars2 forksJavaScriptUpdated July 2026
✅ Reviewed by My AI Guide, vetted for vibe builders and developers

Our Review

Maintained by Google under the gemini-cli-extensions org and released under Apache-2.0, this skill set turns Cloud SQL for MySQL administration into plain-English agent prompts. It ships four task-focused skill bundles so your AI agent handles provisioning, querying, recovery, and performance work directly in the terminal.

What cloud-sql-mysql adds to your AI agent:

  • Admin skill bundle provision new Cloud SQL for MySQL instances, create databases and users, clone environments, and track the progress of long-running infrastructure operations.
  • Data skill bundle explore your schema, run SQL through natural-language requests, and inspect how MySQL plans to execute a statement before you commit to it.
  • Lifecycle skill bundle create backups, restore from earlier states, and clone instances for recovery or testing without hand-writing gcloud commands.
  • Monitor skill bundle troubleshoot slow queries, read system-level PromQL metrics, and surface structural issues like table fragmentation or missing unique indexes.
  • Natural-language queries ask questions like "how many orders shipped in the last 30 days" and the agent translates intent into SQL against your live instance.
  • Code generation ask the agent to generate a Python dataclass or other snippets directly from a table schema to speed up application work.

Compatibility:

The skills install into Antigravity (CLI v1.6.0+ or Antigravity 2.0 v2.0.0+), Claude Code (v2.1.94+), and Codex (v0.117.0+). You can add them through a plugin marketplace, a direct git clone, or the npx skills add command. Authentication uses Application Default Credentials by default, with optional CLOUD_SQL_MYSQL_USER and CLOUD_SQL_MYSQL_PASSWORD environment variables, and public, private, or PSC IP types.

Limitations:

This project is in beta (pre-v1.0 at release v0.2.0, April 2026) and may ship breaking changes before a stable release. It works only with Google Cloud SQL for MySQL, so self-hosted or non-GCP MySQL is out of scope. Setup requires a Google Cloud project with the Cloud SQL Admin API enabled plus the Cloud SQL Client, Viewer, and Admin IAM roles, and private-IP instances need the agent to run inside the same VPC. With 10 GitHub stars it is a young project, so expect a small community while the API stabilizes.

Our Verdict

cloud-sql-mysql is the most direct way to drive Google Cloud SQL for MySQL from an AI coding agent in 2026. If you already run databases on Cloud SQL and live inside Claude Code, Gemini CLI, or Codex, these skills remove the context switch to the gcloud console for everyday admin, query, and recovery tasks.

For Vibe Builders, the appeal is talking to your database in plain English. You can spin up an instance, add a read-only user, or ask how many orders shipped last week without learning MySQL syntax or gcloud flags first.

For Developers, the value is in the schema exploration, EXPLAIN-plan inspection, and PromQL-backed monitoring skills. These map cleanly to real debugging work, and the code-generation skill that builds dataclasses from a table schema saves boilerplate.

Skip if you run self-hosted MySQL or a non-Google managed database, since the skills only target Cloud SQL. For a vendor-neutral MySQL workflow, a generic MySQL MCP server is a better fit. As a beta project from Google, treat it as production-adjacent: useful now, but pin a release and watch the changelog for breaking changes.

Frequently Asked Questions

What is cloud-sql-mysql?

cloud-sql-mysql is an open-source set of agent skills, maintained by Google under the gemini-cli-extensions organization, that lets AI coding agents manage Google Cloud SQL for MySQL databases through natural language. It bundles four skill sets for administration, data queries, lifecycle backups, and monitoring, and works inside Antigravity, Claude Code, and Codex.

Is cloud-sql-mysql free and open source?

Yes, cloud-sql-mysql is free and open source under the Apache-2.0 license, with the full source available on GitHub under the gemini-cli-extensions organization. The skills themselves carry no fee, though you still pay Google Cloud for the underlying Cloud SQL for MySQL instances you provision and run through them.

Which AI agents support cloud-sql-mysql?

As of 2026, cloud-sql-mysql installs into Antigravity (CLI v1.6.0 or higher, or Antigravity 2.0 v2.0.0 or higher), Claude Code (v2.1.94 or higher), and Codex (v0.117.0 or higher). You can add it through a plugin marketplace, a direct git clone, or the npx skills add command, and verify it loaded with each agent's plugin or skills listing command.

How does cloud-sql-mysql differ from a generic MySQL MCP server?

cloud-sql-mysql is purpose-built for Google Cloud SQL, so it handles GCP-native tasks like instance provisioning, IAM authentication, backups, and PromQL monitoring that a vendor-neutral MySQL server cannot. Choose cloud-sql-mysql when your database lives on Cloud SQL, and choose a generic MySQL MCP server when you run self-hosted or non-Google databases.

What do I need to get started with cloud-sql-mysql?

You need a supported agent installed, a Google Cloud project with the Cloud SQL Admin API enabled, and Application Default Credentials available in your environment. Grant the Cloud SQL Client, Viewer, and Admin IAM roles, set your project, region, and instance environment variables, then install the skills and ask the agent to perform database tasks in plain English.

How do I install cloud-sql-mysql?

Visit the GitHub repository at https://github.com/gemini-cli-extensions/cloud-sql-mysql for installation instructions.

What license does cloud-sql-mysql use?

cloud-sql-mysql uses the Apache-2.0 license.

What are alternatives to cloud-sql-mysql?

Explore related tools and alternatives on My AI Guide.

🔒

Open source: source code publicly visible

Anyone can inspect exactly what this repo does on GitHub before using it. Apache-2.0 licensed.

Reviewed by My AI Guide for relevance, quality, and active maintenance before listing.

Install in Claude Code:

/install cloud-sql-mysql

Related Tools

View all