# Neon

Manage Neon projects, branches, and databases directly from Claude Code, Cursor, or GitHub Copilot. Execute SQL queries, create temporary branches for safe schema migrations, and optimize query performance with built-in analysis.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1350 installs
- Author: neon
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/neon
- Updated: 2026-01-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/neon-neon

## What it does

Neon is an MCP server that connects eight IDEs and code assistants to Neon's database management platform. You can list and create projects, execute SQL statements and transactions, manage branches, inspect table schemas, and compare database structures across branches.

For safe migrations, the server creates temporary branches where you test DDL changes separately before applying them to production. Slow query detection hooks into `pg_stat_statements` to surface performance bottlenecks and suggest optimizations based on execution plans.

The server also provisions Neon Auth (a managed authentication layer) and Neon Data API (HTTP endpoints for database access with JWT). You need a Neon account to use it; the server communicates with `https://neon.run.tools`.

## Requirements
- Remote server: `https://neon.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http neon https://neon.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add neon-neon --url https://neon.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "neon-neon": {
            "url": "https://neon.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "neon-neon": {
            "type": "http",
            "url": "https://neon.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http neon-neon https://neon.run.tools
```

## When to use it
- Run a SQL query against a Neon database without leaving the IDE
- Test a schema migration on a temporary branch before deploying to the main database
- Identify slow queries and get performance tuning recommendations
- Check what changed in the database schema between two branches
- Set up Neon Auth or the Data API on a branch in one step

## Example prompts
- List all my Neon projects and show details for the one named "app-db"
- Create a temporary branch and add an `email` column to the `users` table, then explain the changes
- Which queries are running slowest in my database right now?

## Similar
- [neon-postgres](https://affpapa.org/en/nevibecode/skills/neondatabase-neon-postgres.md) — skill · 315000 installs
- [neon-postgres-branches](https://affpapa.org/en/nevibecode/skills/neon-postgres-branches.md) — skill · 37300 installs
- [neon-database-architect](https://affpapa.org/en/nevibecode/agents/neon-database-architect.md) — subagent · 478 installs
- [neon-auth-specialist](https://affpapa.org/en/nevibecode/agents/neon-auth-specialist.md) — subagent · 387 installs
- [Neon Migration Specialist](https://affpapa.org/en/nevibecode/agents/neon-migration-specialist.md) — subagent · ★ 41430 repo stars
- [Neon Performance Analyzer](https://affpapa.org/en/nevibecode/agents/neon-performance-analyzer.md) — subagent · ★ 41430 repo stars

## Other versions with the same name
- [Neon · neondatabase](https://affpapa.org/en/nevibecode/mcp/neon.md) — ★ 667 repo stars
- [Neon · neondatabase-labs](https://affpapa.org/en/nevibecode/mcp/neondatabase-labs-neon.md)

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
