How to integrate Neon MCP with Claude Code

Manage your Neon directly from Claude Code with zero worries about OAuth hassles, API-breaking issues, or reliability and security concerns. You can do this in two different ways: Via Composio Connect - Direct and easiest approach Via Composio SDK - Programmatic approach with more control

Neon logoNeon
Api Key

Neon is a serverless Postgres platform for building scalable apps faster. Its serverless architecture helps you launch, scale, and manage Postgres with zero overhead.

107 Tools

Introduction

Manage your Neon directly from Claude Code with zero worries about OAuth hassles, API-breaking issues, or reliability and security concerns.

You can do this in two different ways:

  1. Via Composio Connect - Direct and easiest approach
  2. Via Composio SDK - Programmatic approach with more control

Also integrate Neon with

Why use Composio?

  • Only one MCP URL to connect multiple apps with Claude Code with zero auth hassles.
  • Programmatic tool calling allows LLMs to write its code in a remote workbench to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Handling Large tool responses out of LLM context to minimize context rot.
  • Dynamic just-in-time access to 20,000 tools across 1000+ other Apps for cross-app workflows. It loads the tools you need, so LLMs aren't overwhelmed by tools you don't need.

Connecting Neon to Claude Code using Composio

1. Add the Composio MCP to Claude

Terminal

2. Start Claude Code

bash
claude

3. Open your MCP list

bash
/mcp

4. Select Composio and click on Authenticate

Select Composio and click Authenticate

5. This will redirect you to the Composio OAuth page. Complete the flow by authorizing Composio and you're all set.

Composio OAuth authorization page
Composio authorization complete
Ask Claude to connect to your account and authenticate via the link

What is the Neon MCP server, and what's possible with it?

The Neon MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Neon account. It provides structured and secure access to your serverless Postgres databases and project infrastructure, so your agent can perform actions like managing projects, configuring authentication, creating branches, and automating database operations on your behalf.

  • Project management and insights: Retrieve detailed information about specific Neon projects, including configurations, workflows, and current status for monitoring or troubleshooting.
  • Automated role and permission setup: Grant email-based permissions, add new roles to branches, and streamline access control across your projects with granular, automated adjustments.
  • Seamless API key and authentication management: Create new API keys for organizations or projects, manage authentication flows, and securely handle access credentials for integrations.
  • Database and branch orchestration: Spin up new Postgres databases within branches, create and configure compute endpoints, and automate the creation of development, testing, or isolated environments as needed.
  • Custom project provisioning: Launch new Neon projects with advanced quota, resource, and networking settings—tailored to your application's requirements and operational best practices.

Connecting Neon via Composio SDK

Composio SDK is the underlying tech that powers Rube. It's a universal gateway that does everything Rube does but with much more programmatic control. You can programmatically generate an MCP URL with the app you need (here Neon) for even more tool search precision. It's secure and reliable.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step10 STEPS
1

Prerequisites

Before starting, make sure you have:
  • Claude Pro, Max, or API billing enabled Anthropic account
  • Composio API Key
  • A Neon account
  • Basic knowledge of Python or TypeScript
2

Install Claude Code

bash
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

To install Claude Code, use one of the following methods based on your operating system:

3

Set up Claude Code

bash
cd your-project-folder
claude

Open a terminal, go to your project folder, and start Claude Code:

  • Claude Code will open in your terminal
  • Follow the prompts to sign in with your Anthropic account
  • Complete the authentication flow
  • Once authenticated, you can start using Claude Code
Claude Code initial setup showing sign-in prompt
Claude Code terminal after successful login
4

Set up environment variables

bash
COMPOSIO_API_KEY=your_composio_api_key_here
USER_ID=your_user_id_here

Create a .env file in your project root with the following variables:

  • COMPOSIO_API_KEY authenticates with Composio (get it from Composio dashboard)
  • USER_ID identifies the user for session management (use any unique identifier)
5

Install Composio library

npm install @composio/core dotenv

Install the Composio TypeScript library to create MCP sessions.

  • @composio/core provides the core Composio functionality
  • dotenv loads environment variables from your .env file
6

Generate Composio MCP URL

import 'dotenv/config';
import { Composio } from '@composio/core';

const { COMPOSIO_API_KEY, USER_ID } = process.env;

if (!COMPOSIO_API_KEY || !USER_ID) {
  throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
}

const composioClient = new Composio({ apiKey: COMPOSIO_API_KEY });

const composioSession = await composioClient.create(USER_ID, {
  toolkits: ['neon'],
});

const composioMcpUrl = composioSession?.mcp.url;

console.log(`MCP URL: ${composioMcpUrl}`);
console.log(`\nUse this command to add to Claude Code:`);
console.log(`claude mcp add --transport http neon-composio "${composioMcpUrl}" --headers "X-API-Key:${COMPOSIO_API_KEY}"`);

Create a script to generate a Composio MCP URL for Neon. This URL will be used to connect Claude Code to Neon.

What's happening

  • We import the Composio client and load environment variables
  • Create a Composio instance with your API key
  • Call create() to create a Tool Router session for Neon
  • The returned mcp.url is the MCP server URL that Claude Code will use
  • The script prints this URL so you can copy it
7

Run the script and copy the MCP URL

node --loader ts-node/esm generate_mcp_url.ts
# or if using tsx
tsx generate_mcp_url.ts

Run your TypeScript script to generate the MCP URL.

  • The script connects to Composio and creates a Tool Router session
  • It prints the MCP URL and the exact command you need to run
  • Copy the entire claude mcp add command from the output
8

Add Neon MCP to Claude Code

bash
claude mcp add --transport http neon-composio "YOUR_MCP_URL_HERE" --headers "X-API-Key:YOUR_COMPOSIO_API_KEY"

# Then restart Claude Code
exit
claude

In your terminal, add the MCP server using the command from the previous step. The command format is:

  • claude mcp add registers a new MCP server with Claude Code
  • --transport http specifies that this is an HTTP-based MCP server
  • The server name (neon-composio) is how you'll reference it
  • The URL points to your Composio Tool Router session
  • --headers includes your Composio API key for authentication

After running the command, close the current Claude Code session and start a new one for the changes to take effect.

9

Verify the installation

bash
claude mcp list

Check that your Neon MCP server is properly configured.

  • This command lists all MCP servers registered with Claude Code
  • You should see your neon-composio entry in the list
  • This confirms that Claude Code can now access Neon tools

If everything is wired up, you should see your neon-composio entry listed:

Claude Code MCP list showing the toolkit MCP server
10

Authenticate Neon

The first time you try to use Neon tools, you'll be prompted to authenticate.

  • Claude Code will detect that you need to authenticate with Neon
  • It will show you an authentication link
  • Open the link in your browser (or copy/paste it)
  • Complete the Neon authorization flow
  • Return to the terminal and start using Neon through Claude Code

Once authenticated, you can ask Claude Code to perform Neon operations in natural language. For example:

  • "Create a new Neon project with autoscaling"
  • "Add a developer's email permission to a project"
  • "Spin up a new branch database for testing"

Complete Code

Here's the complete code to get you started with Neon and Claude Code:

import 'dotenv/config';
import { Composio } from '@composio/core';

const { COMPOSIO_API_KEY, USER_ID } = process.env;

if (!COMPOSIO_API_KEY || !USER_ID) {
  throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
}

const composioClient = new Composio({ apiKey: COMPOSIO_API_KEY });

const composioSession = await composioClient.create(USER_ID, {
  toolkits: ['neon'],
});

const composioMcpUrl = composioSession?.mcp.url;

console.log(`MCP URL: ${composioMcpUrl}`);
console.log(`\nUse this command to add to Claude Code:`);
console.log(`claude mcp add --transport http neon-composio "${composioMcpUrl}" --headers "X-API-Key:${COMPOSIO_API_KEY}"`);

Conclusion

You've successfully integrated Neon with Claude Code using Composio's MCP server. Now you can interact with Neon directly from your terminal using natural language commands.

Key features of this setup:

  • Terminal-native experience without switching contexts
  • Natural language commands for Neon operations
  • Secure authentication through Composio's managed MCP
  • Tool Router for dynamic tool discovery and execution

Next steps:

  • Try asking Claude Code to perform various Neon operations
  • Add more toolkits to your Tool Router session for multi-app workflows
  • Integrate this setup into your development workflow for increased productivity

You can extend this by adding more toolkits, implementing custom workflows, or building automation scripts that leverage Claude Code's capabilities.

TOOLS

Supported Tools

Every Neon action and event your agent gets out of the box.

Accept project transfer request

Tool to accept a transfer request for a Neon project.

Access project details by id

Retrieves detailed information about a specific Neon serverless Postgres project.

Add new jwks to project endpoint

Adds a new JSON Web Key Set (JWKS) URL to a Neon project for JWT-based authentication.

Add project email permission

Adds permissions for a specified email address to a particular project within the Neon B2B SaaS integration platform.

Add role to branch

Creates a new PostgreSQL role within a specific branch of a Neon project.

Count project branches

Tool to get the total number of branches in a Neon project.

Create API Key for Organization

Creates a new API key for the specified organization in Neon.

Create Auth Provider SDK Keys

Tool to generate SDK or API keys for authentication providers.

Create auth user

Tool to create a new user in Neon Auth for a specific project branch.

Create branch database

Creates a new database within a specified project and branch in the Neon platform.

Enable Neon Auth for branch

Tool to enable Neon Auth integration for a branch.

Create Neon Data API

Creates a new instance of Neon Data API in the specified branch.

Create branch snapshot

Creates a snapshot from the specified branch at a specific point in time.

Create compute endpoint

Creates a new compute endpoint for a specified branch within a Neon project.

Create New API Key

Creates a new personal API key for the authenticated Neon user account.

Create new project branch

Creates a new branch in a Neon project.

Create anonymized branch

Creates a new branch with anonymized data using PostgreSQL Anonymizer for static masking.

Create project transfer request

Tool to create a transfer request for a Neon project.

Create project with quota and settings

Creates a new Neon project with specified configuration settings.

Set VPC endpoint restriction

Sets or updates a VPC endpoint restriction for a Neon project.

Assign or Update VPC Endpoint

Assigns an AWS VPC endpoint to a Neon organization for Private Networking, or updates the label of an existing VPC endpoint assignment.

Delete api key by id

Deletes a specific API key from the Neon platform.

Delete auth domains

Deletes domains from the redirect_uri whitelist for a specific branch's authentication configuration.

Delete OAuth provider

Deletes an OAuth provider configuration from a specific branch in a Neon project.

Delete auth user

Deletes an authentication user from a specified branch within a Neon project.

Delete branch data API

Deletes the Neon Data API for a specified branch and database.

Delete database from branch

Deletes a specific database from a designated branch within a project in the Neon platform.

Delete organization api key

Deletes a specific API key associated with an organization in the Neon platform.

Delete organization member

Removes a specific member from a Neon organization.

Delete project branch by id

Deletes a specific branch within a project in the Neon B2B SaaS integration platform.

Delete project branch role

Deletes a PostgreSQL role from a specific branch within a Neon project.

Delete project by id

Permanently deletes a Neon PostgreSQL project and all its associated resources.

Delete project endpoint

Deletes a specific endpoint within a Neon project.

Delete project jwks by id

Deletes a specific JSON Web Key Set (JWKS) associated with a given project in the Neon B2B SaaS integration platform.

Delete project permission

Deletes a specific permission associated with a project in the Neon B2B SaaS integration platform.

Delete project snapshot

Deletes a specific snapshot for a project in Neon.

Delete vpc endpoint by ids

Permanently deletes a VPC endpoint from a Neon organization in a specified AWS region.

Delete vpc endpoint by project id

Deletes a specific VPC endpoint within a designated project in the Neon platform.

Disable branches auth

Tool to disable Neon Auth for a specific branch in a Neon project.

Fetch database for branch

Retrieves a list of databases associated with a specific project and branch in the Neon platform.

Fetch organization members by id

Retrieves a list of all members associated with a specific organization in the Neon B2B SaaS integration platform.

Fetch vpcendpoint details by id

Retrieves the current state and configuration details of a specific VPC endpoint assigned to a Neon organization.

Finalize branch restore

Finalizes the restore operation for a branch created from a snapshot.

Get auth

Retrieves authentication information about the current API request credentials.

Get auth allow localhost

Retrieves the allow localhost configuration for a specific branch in a Neon project.

Get auth email provider

Retrieves the email provider configuration for Neon Auth on a specific branch.

Get available preload libraries

Retrieves the list of available shared preload libraries for a Neon project.

Get branches anonymized status

Retrieves the current status of an anonymized branch, including its state and progress information.

Get branches backup schedule

Retrieves the backup schedule configuration for a specified branch within a Neon project.

Get Neon Data API for branch

Retrieves the Neon Data API information for a specific branch and database.

Get branches for project

Retrieves a list of branches associated with a specific project in the Neon B2B SaaS integration platform.

Get branches masking rules

Retrieves the masking rules for the specified anonymized branch.

Get branch roles for project

Retrieves the roles associated with a specific branch within a project in the Neon B2B SaaS integration platform.

Get consumption history projects

Retrieves consumption history for projects within a Neon organization.

Get current user information

Retrieves the profile information for the currently authenticated user.

Get organization api keys

Retrieves a list of all API keys associated with a specific organization in the Neon B2B SaaS integration platform.

Get project branches

Retrieves detailed information about a specific branch within a Neon project.

Get project branch role

Retrieves detailed information about a specific role within a particular branch of a Neon project.

Get project branch schema comparison

Compares the database schema of a branch with another branch's schema in a Neon project.

Get project connection uri

Retrieves the connection URI for a specified project within the Neon B2B SaaS integration platform.

Get project endpoint information

Retrieves a list of all compute endpoints associated with a specific Neon project.

Get project operation by id

Retrieves detailed information about a specific operation within a Neon serverless PostgreSQL project.

Get schema for project branch

Retrieves the PostgreSQL database schema (DDL) for a specific database on a branch within a Neon project.

Get user organizations

Retrieves a list of organizations associated with the currently authenticated user in the Neon platform.

Get vpc region endpoints

Retrieves a list of VPC endpoints for a specified organization within a particular AWS region.

List api keys

Retrieves a list of API keys associated with the authenticated user's Neon account.

List auth domains

Lists the domains in the redirect_uri whitelist for the specified project and branch.

List Auth OAuth Providers

Retrieves the OAuth providers configured for Neon Auth on a specific branch.

List project snapshots

Tool to list all snapshots for a specified Neon project.

List shared projects

Retrieves a list of Neon Postgres projects shared with your account.

List VPC endpoints for organization

Tool to retrieve the list of VPC endpoints for a specified Neon organization across all regions.

Modify branch details in project

Updates the details of a specific branch within a project in the Neon platform.

Patch branch database information

Updates the properties of a specific database within a project branch in the Neon platform.

Reset role password for branch

Resets the password for a PostgreSQL role on a specific Neon branch and generates a new password.

Restart project endpoint

Restarts a Neon compute endpoint (Postgres instance) within a project.

Restore project branch

This endpoint restores a branch to a specific state or point in time.

Restore snapshot to new branch

Tool to restore a Neon snapshot to a new branch.

Retrieve account consumption history

Retrieves the consumption history for a specified account within the Neon platform.

Retrieve all regions

Retrieves a list of available geographic regions supported by the Neon B2B SaaS integration platform.

Retrieve branch database details

Retrieves detailed information about a specific database within a Neon project and branch.

Retrieve branch endpoints

Retrieves all compute endpoints associated with a specific branch in a Neon project.

Retrieve jwks for project

Retrieves the JSON Web Key Set (JWKS) for a specified project.

Retrieve organization by id

Retrieves detailed information about a specific organization within the Neon platform.

Retrieve organization invitations

Retrieves a list of all pending invitations for a specified organization.

Retrieve organization member info

Retrieves detailed information about a specific member within an organization in the Neon B2B SaaS integration platform.

Retrieve project endpoint details

Retrieves detailed information about a specific compute endpoint within a Neon serverless PostgreSQL project.

Retrieve project operations

Retrieves a list of operations associated with a specific project in the Neon B2B SaaS integration platform.

Retrieve project permissions

Retrieves the current permissions settings for a specific project within the Neon B2B SaaS integration platform.

Retrieve projects list

Retrieves a list of all Neon projects associated with the authenticated user's account.

Retrieve vpc endpoints for project

Retrieves a list of VPC (Virtual Private Cloud) endpoints associated with a specific project in the Neon B2B SaaS integration platform.

Reveal role password in branch

Reveals the password for a specific role within a branch of a Neon project.

Send auth test email

Tool to send a test email using specified SMTP configuration for Neon Auth.

Send organization invitations

Creates and sends invitations to join an organization in the Neon B2B SaaS integration platform.

Set branch as default

Sets a specified branch as the default branch for a given project in Neon.

Start branch anonymization

Starts the anonymization process for an anonymized branch that is in the initialized, error, or anonymized state.

Start endpoint for project

Starts a suspended or idle compute endpoint for a Neon PostgreSQL project.

Suspend project endpoint by id

Suspends a specific endpoint within a project in the Neon B2B SaaS integration platform.

Transfer projects between organizations

Transfers selected projects from one organization to another organization.

Transfer user projects to organization

Transfers multiple projects from the authenticated user's personal account to a specified organization within the Neon B2B SaaS integration platform.

Update auth allow localhost

Updates the allow localhost configuration for a specific branch in a Neon project.

Update branch auth email provider

Updates the email provider configuration for a specific branch's authentication system.

Update branches data API

Updates the Neon Data API configuration for the specified branch.

Update branches masking rules

Updates the masking rules for the specified anonymized branch.

Update organization member role

Updates the role of a specific member within an organization in the Neon B2B SaaS integration platform.

Update project compute endpoint settings

Updates the configuration of a specific compute endpoint within a Neon project.

Update project settings by id

Updates the configuration and settings of a specific Neon project.

Update project snapshot

Tool to update the name of a specific snapshot in a Neon project.

FAQ

Frequently asked questions

With a standalone Neon MCP server, the agents and LLMs can only access a fixed set of Neon tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Neon and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Code fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Neon tools.

Yes, absolutely. You can configure which Neon scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Neon data and credentials are handled as safely as possible.

Start with Neon.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Neon tool your agent needs.Free to start.

Start building