Neon

MCP server that manages Neon projects, branches, SQL execution, and migrations via natural language.

typescript

0

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-neondatabase_mcp-server-neon": {
      "command": "npx",
      "args": [
        "@neondatabase/mcp-server-neon",
        "init",
        "$NEON_API_KEY"
      ],
      "env": {
        "NEON_API_KEY": "YOUR_NEON_API_KEY"
      }
    }
  }
}

You can manage Neon database contexts from any MCP client using the Neon MCP Server. It lets you operate Neon projects, databases, tables, and migrations with natural language requests, enabling you to create projects, run SQL, and perform migrations through simple commands.

How to use

Connect your MCP client to the Neon MCP Server to start managing Neon projects and databases with natural language. Typical tasks include listing Neon projects, describing a project, creating or deleting projects and branches, running SQL statements, and performing migrations. Use simple, conversational prompts like: “List all my Neon projects” or “Create a new table named users with columns id, name, and email.” The server translates your requests into Neon API actions and returns results back to your MCP client.

How to install

Prerequisites you need before installing and running the Neon MCP Server:

Node.js must be installed on your machine.

You also need a Neon API key with access to your Neon projects.

Install the Neon MCP Server for your MCP client using the initialization command shown below.

Step-by-step local setup

npx @neondatabase/mcp-server-neon init $NEON_API_KEY

Optional client installation via Smithery

You can install Neon MCP Server support for a Claude Desktop client using a helper tool. Run this command to install automatically.

npx -y @smithery/cli install neon --client claude

Available tools

list_projects

List all Neon projects you have access to.

describe_project

Describe a specific Neon project and its attributes.

create_project

Create a new Neon project.

delete_project

Delete an existing Neon project.

create_branch

Create a new branch within a Neon project.

delete_branch

Delete a branch from a Neon project.

describe_branch

Describe details of a specific branch.

run_sql

Execute a SQL statement against a Neon database.

run_sql_transaction

Run a SQL transaction against a Neon database.

get_database_tables

List tables in a Neon database.

describe_table_schema

Describe the schema of a Neon table.

prepare_database_migration

Prepare and start a database migration in a temporary branch.

complete_database_migration

Commit a prepared migration to the main branch.