---
title: "Neon Postgres MCP Server Setup Guide and Schema"
slug: "neon"
category: "databases"
package: "@neondatabase/mcp-server-neon"
transport: "stdio"
canonical: "https://mcp-codex.com/servers/neon"
source: "MCP Codex (https://mcp-codex.com)"
dateModified: "2026-09-28"
---

# Neon Postgres MCP Server

> Serverless PostgreSQL with branching, point-in-time restore, and autoscaling.

## Overview
Manage Neon serverless PostgreSQL databases via MCP. Create database branches, run queries, manage schemas, and leverage Neon's unique branching model for development and testing workflows.

## Quick Install
```bash
npx -y @neondatabase/mcp-server-neon
```

## Environment Variables

| Variable | Description | Required |
| :--- | :--- | :--- |
| `NEON_API_KEY` | Neon API key | **Yes** |

## Client Configurations

### Claude Desktop (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "neon": {
      "command": "npx",
      "args": [
        "-y",
        "@neondatabase/mcp-server-neon"
      ],
      "env": {
        "NEON_API_KEY": ""
      }
    }
  }
}
```

### Cursor (`mcp.json`)
```json
{
  "mcpServers": {
    "neon": {
      "command": "npx",
      "args": [
        "-y",
        "@neondatabase/mcp-server-neon"
      ],
      "env": {
        "NEON_API_KEY": ""
      }
    }
  }
}
```

### OpenAI Codex CLI (`~/.codex/config.toml`)
```toml
[mcp_servers.neon]
command = "npx"
args = ["-y", "@neondatabase/mcp-server-neon"]

[mcp_servers.neon.env]
NEON_API_KEY = ""
```

## Available Tools (4)

- `list_projects`
- `create_branch`
- `run_sql`
- `list_databases`

## Documentation & Links
- Canonical Web Page: https://mcp-codex.com/servers/neon
- Weekly Protocol Changelog: https://mcp-codex.com#newsletter
- GitHub Repository: https://github.com/neondatabase/mcp-server-neon