# Neon (MCP server)

> Neon is an MCP server that adds database tools to AI assistants such as Claude Code, Cursor and VS Code. Official Neon MCP server for managing Neon projects and Lakebase Postgres databases. It has 648 GitHub stars, is released under the MIT license and runs as a remote server at https://mcp.neon.tech/mcp.

Neon MCP Server is an open-source tool that lets you interact with your Lakebase Postgres databases on Neon in natural language.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/neondatabase/mcp-server-neon |
| GitHub stars | 648 |
| License | MIT |
| Language | TypeScript |
| Transport | streamable-http |
| Packages | none (remote only) |
| Remote URL | https://mcp.neon.tech/mcp |
| Needs API key | yes |
| Official | yes |
| Works with | Claude Code, Cursor, VS Code, Claude.ai, ChatGPT |
| Category | Databases |
| Latest release | none |
| Last commit | Oct 4, 2026 |
| MCP registry name | com.neon/mcp |

## Install

### Claude Desktop

```
Settings > Connectors > Add custom connector
URL: https://mcp.neon.tech/mcp
```

Remote servers are added as a custom connector, not in claude_desktop_config.json.

### Claude Code

```sh
claude mcp add --transport http neon "https://mcp.neon.tech/mcp"
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "neon": {
      "url": "https://mcp.neon.tech/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "neon": {
      "type": "http",
      "url": "https://mcp.neon.tech/mcp"
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Tools

- `projects`
- `branches`
- `endpoints`
- `snapshots`
- `schema`
- `querying`
- `neon_auth`
- `data_api`
- `observability`
- `docs`
- `functions`
- `storage`
- `null`
- `list_projects`: Lists Neon projects. limit caps how many items come back.
- `describe_project`: Fetches a Neon project by id ({ "projectid": "…" }).
- `create_project`: Creates a Neon project and waits for the default compute. Does not return a connection string.
- `delete_project`: Deletes an existing Neon project. Arguments are { "projectid": "…" }.
- `list_organizations`: Lists all organizations that the current user has access to. Optionally filter by organization name or ID using the…
- `list_branches`: Lists branches in a project. Use it to resolve a branch name to a br-… id.
- `list_credentials`: , createcredential, revokecredential, rotatecredential: Branch-scoped credentials for Object Storage and the AI…
- `create_branch`: Creates a branch with a read-write compute and waits until it is ready. Does not return a connection string.
- `reset_from_parent`: Resets a branch to its parent's current HEAD ({ "projectid": "…", "branchid": "br-…" }).
- `delete_branch`: Deletes a branch ({ "projectid": "…", "branchid": "br-…" }).
- `describe_branch`: Retrieves a tree of databases, schemas, tables, views, and functions on a branch.
- `restore_snapshot`: Restores a snapshot. Pass targetbranchid to restore onto an existing branch; omit it to create a new one.
- `list_postgres_endpoints`: , listbranchcomputes, getpostgresendpoint, createpostgresendpoint, updatepostgresendpoint, deletepostgresendpoint,…
- `list_snapshots`: , getsnapshotschedule, setsnapshotschedule, createsnapshot, updatesnapshot, deletesnapshot, restoresnapshot
- `get_database_tables`: , describetableschema
- `compare_database_schema`: SQL schema diff of one database against another branch. databasename is required.
- `get_connection_string`: Returns your database connection string.
- `run_sql`: Executes a single SQL query against a specified Neon database. Supports both read and write operations.
- `run_sql_transaction`: Executes a series of SQL queries within a single transaction against a Neon database.
- `describe_table_schema`: Retrieves the schema definition of a specific table, detailing columns, data types, and constraints.
- `prepare_database_migration`: Initiates a database migration process. Critically, it creates a temporary branch to apply and test the migration…
- `complete_database_migration`: Finalizes and applies a prepared database migration to the main branch.
- `inspect_database`: Runs one of 15 predefined read-only Postgres diagnostics against a branch — relation and index sizes, index and…
- `list_slow_queries`: Identifies performance bottlenecks by finding the slowest queries in a database.
- `explain_sql_statement`: Provides detailed execution plans for SQL queries to help identify performance bottlenecks.
- `prepare_query_tuning`: Analyzes query performance and suggests optimizations, like index creation.
- `complete_query_tuning`: Finalizes query tuning by either applying optimizations to the main branch or discarding them.

## Similar MCP servers

- [Dbx](https://appsgit.com/mcp-servers/dbx): Query databases from AI agents using connections configured in DBX. (24,945 stars, Apache-2.0)
- [Butterbase AI MCP Server](https://appsgit.com/mcp-servers/butterbase-ai-mcp-server): Butterbase MCP server — manage your backend: schemas, auth, functions, storage, RAG, deploys. (3,686 stars, Apache-2.0, needs API key)
- [DBHub](https://appsgit.com/mcp-servers/dbhub): Token-efficient database MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite. (3,610 stars, MIT, needs API key)
- [LINQ to DB](https://appsgit.com/mcp-servers/linq-to-db): Inspect database schemas and execute SQL queries across multiple database providers with LINQ to DB. (3,332 stars, MIT)
- [Mindwtr](https://appsgit.com/mcp-servers/mindwtr): Task automation via SQLite, desktop Local API, or Mindwtr Cloud; read-only by default. (2,211 stars, AGPL-3.0, needs API key)
- [MCP Memory Service](https://appsgit.com/mcp-servers/mcp-memory-service): Open-source persistent memory for AI agent pipelines (LangGraph, CrewAI, AutoGen) and Claude. (1,988 stars, Apache-2.0)

---

Canonical page: https://appsgit.com/mcp-servers/neon
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.