Neon MCP Server

✓ verified

Manage Neon serverless Postgres branches and run SQL.

Don't have ToolPiper? We'll take you to the download.

Open repository →

Publisher

Neon

License

MIT

Transport

Local subprocess

Tools

5

What this server does

Neon is serverless Postgres with instant branching; this official server lets the assistant use that branching as a safety net. List projects, run SQL, describe schemas, and create branches. The standout workflow is migrations: the server stages schema changes on a temporary branch first, so the model can verify a migration in isolation before you apply it to your main branch. That makes 'let the AI evolve my schema' far less terrifying than running DDL straight at production.

Tools included

  • list_projects

    List your Neon projects.

  • run_sql

    Run a SQL statement against a project's database.

  • create_branch

    Create a database branch.

  • describe_table_schema

    Describe a table's schema.

  • prepare_database_migration

    Stage a schema migration on a temporary branch.

The authoritative list comes from the server's tools/list at runtime. This catalog entry may lag the upstream until the next ToolPiper release.

Install in ToolPiper

ToolPiper handles the JSON configuration. Click Install, fill in any required tokens, and the server is ready in your chat.

Don't have ToolPiper? We'll take you to the download.

Install in another client

Install in another MCP client (Claude Desktop, Cursor, Continue, Cline)

Add this to ~/Library/Application Support/Claude/claude_desktop_config.json.

{
  "mcpServers": {
    "neon": {
      "command": "npx",
      "args": [
        "-y",
        "@neondatabase/mcp-server-neon",
        "start",
        "${NEON_API_KEY}"
      ]
    }
  }
}

Example prompts

  • "List my Neon projects and the databases in each."

  • "Create a branch called ai-experiment and run a SELECT to check the users table."

  • "Prepare a migration that adds a 'last_login' timestamp column to users."

Security notes

The API key controls your Neon account: it can create branches, run SQL, and apply migrations. Treat it as a credential and rotate it from the Neon console if it leaks. The branch-first migration flow limits blast radius, but run_sql can still modify the branch it targets. Point experiments at a branch, not your production database.

Related tools