Manage Neon Postgres projects and branches and run SQL queries in natural language via the Neon Management API.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add neon --env NEON_API_KEY='<NEON_API_KEY>' -- npx neonctl@latest init~/.codex/config.toml
[mcp_servers.neon]
command = "npx"
args = ["neonctl@latest", "init"]
env = { NEON_API_KEY = "<NEON_API_KEY>" }
# codex mcp add neon --env NEON_API_KEY='<NEON_API_KEY>' -- npx neonctl@latest init~/.cursor/mcp.json
{
"mcpServers": {
"neon": {
"command": "npx",
"args": [
"neonctl@latest",
"init"
],
"env": {
"NEON_API_KEY": "<NEON_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"neon": {
"type": "stdio",
"command": "npx",
"args": [
"neonctl@latest",
"init"
],
"env": {
"NEON_API_KEY": "<NEON_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"neon": {
"command": "npx",
"args": [
"neonctl@latest",
"init"
],
"env": {
"NEON_API_KEY": "<NEON_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"neon": {
"command": "npx",
"args": [
"neonctl@latest",
"init"
],
"env": {
"NEON_API_KEY": "<NEON_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"neon": {
"command": "npx",
"args": [
"neonctl@latest",
"init"
],
"env": {
"NEON_API_KEY": "<NEON_API_KEY>"
}
}
}
}Remote
claude mcp add --transport http neon https://mcp.neon.tech/mcp --header 'Authorization: <AUTHORIZATION>'~/.codex/config.toml
[mcp_servers.neon]
url = "https://mcp.neon.tech/mcp"
http_headers = { Authorization = "<AUTHORIZATION>" }
# codex mcp add neon --url https://mcp.neon.tech/mcp~/.cursor/mcp.json
{
"mcpServers": {
"neon": {
"url": "https://mcp.neon.tech/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"neon": {
"type": "http",
"url": "https://mcp.neon.tech/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"neon": {
"httpUrl": "https://mcp.neon.tech/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"neon": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.neon.tech/mcp",
"--header",
"Authorization:<AUTHORIZATION>"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"neon": {
"url": "https://mcp.neon.tech/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}Environment variables
NEON_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.