How to Use the Neon MCP in Claude Code

Q: Can Claude Code create read replicas in Neon?

It handles this by calling createendpoint and specifying the read-only type. The command returns a new host address that you can pipe into your load balancer config.

Q: Does this tool require me to manually copy passwords?

No. Commands like createrole and getconnectionuri return the generated passwords and full connection strings directly to stdout. You can route that output straight into a secrets manager.

Q: How does Claude Code handle Neon project updates?

The CLI uses updateproject to rename workspaces without affecting the underlying databases or endpoints. It is a metadata change that happens instantly.

Manage serverless Postgres environments straight from the terminal. Let Claude Code provision branches and endpoints in your CI/CD pipeline.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Neon MCP to Claude Code

Create your Vinkius account to connect Neon to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Neon with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Ephemeral DBs for CI/CD pipelines

The Neon MCP Server provides terminal-based agents with `create_branch` to build zero-copy Postgres environments for automated testing. Claude Code intercepts a deployment trigger, spins up an exact replica of production data, and runs your integration tests against it in seconds. You get realistic test runs without touching live data or waiting for massive SQL dumps to restore. After the test suite passes, the agent runs `delete_branch` to tear down the temporary infrastructure, keeping your resource usage strictly bounded.

Headless workspace initialization

Bootstrapping a new microservice backend happens via `create_project` directly from your shell environment. You tell the CLI to provision a cluster in a specific AWS region, and it handles the database creation, default branching, and compute allocation automatically. Security provisioning is equally scriptable. Claude Code executes `create_role` to generate unique passwords for your application services, then pulls the details using `get_connection_uri` to inject them into your deployment manifests.

Infrastructure auditing via MCP

Auditing your database footprint requires nothing more than asking your CLI to execute `list_projects` and `list_endpoints`. The agent maps out every active read-write node, idle compute instance, and suspended branch across your entire organization. This visibility allows for aggressive cleanup of abandoned resources. If developers leave zombie environments running, you can instruct the agent to run `delete_project` or prune specific branches to enforce strict lifecycle management.

Setup guide

Set up Neon MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see neon-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Neon transactions." It will automatically discover and invoke the available Neon tools.

Terminal

claude mcp add --transport http neon-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Neon MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "neon-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Neon. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Neon now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Neon MCP in Claude Code

Run the standard add command in your terminal. Make sure all flags come before the server name so the CLI parses them correctly.

It handles this by calling `create_endpoint` and specifying the read-only type. The command returns a new host address that you can pipe into your load balancer config.

No. Commands like `create_role` and `get_connection_uri` return the generated passwords and full connection strings directly to stdout. You can route that output straight into a secrets manager.

The CLI uses `update_project` to rename workspaces without affecting the underlying databases or endpoints. It is a metadata change that happens instantly.

The integration interacts exclusively with infrastructure state, role credentials, and endpoint addresses, entirely ignoring the actual rows stored in your databases. Ephemeral execution means that any connection strings retrieved are purged from memory the moment your shell script exits.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript