Skip to main content
The Neon MCP Server enables AI agents within Caylex to manage Neon Postgres databases entirely through natural language, eliminating the need for manual console or API interactions. Agents can create and manage Neon projects, branches, and databases; run SQL queries; and perform schema changes conversationally. A standout feature is branch-based migrations, which allow safer schema modifications by isolating changes on dedicated database branches before applying them. Authentication is handled via a Neon API key passed as a Bearer token in the Authorization header, making it well-suited for remote agent workflows within Caylex. This server is designed for development and testing workflows, enabling rapid database setup, table management, and project scaffolding driven by AI agents.
Prerequisites:
  • A Neon account is required; a Free Plan is sufficient to get started, though project and branch limits vary by plan.
  • A Neon API key must be generated from the Neon Console (Settings > API Keys) before adding this server to a Caylex project.
Important API details:
  • The Neon MCP Server is intended for development and testing environments only — always review AI-requested actions before they are executed against your database.
  • Authentication requires a valid Neon API key passed as a Bearer token in the Authorization header (e.g., Authorization: Bearer YOUR_NEON_API_KEY).
  • Each use of neonctl init generates a new Neon API key; users should audit and revoke unused keys from the Neon Console under API Keys settings.
  • Branch-based migrations are the recommended approach for schema changes, as they isolate modifications before applying them to the main database branch.

​
Server Details

PropertyValue
TransportStreamable HTTP
Server TypeExternal
Endpointhttps://mcp.neon.tech/mcp
CategoriesDatabase, Development & DevOps

​
Authentication

This server supports the following authentication methods:

​
OAuth

During the server onboarding flow, you will be prompted to complete the OAuth flow to grant access. See the Neon Authentication guide for step-by-step credential configuration.

​
Header Authentication

This server authenticates via HTTP headers. During the server onboarding flow, you will be prompted to confirm the required headers. Note that you do not provide the values for the headers during the server on-boarding. Header values are provided by the users during the Auth Link flow.

​
Getting Started

1

Add the server

Navigate to the Server Library and click on the New Server button. Find Neon in the Caylex Catalog.
2

Server Onboarding flow

Go through the server onboarding flow.
3

Use in a project

Add the server to a project by configuring project connections. Its tools are now available to any agents connected to that project.
https://d338mlbnszozgc.cloudfront.net/logos/datadog.svg

Datadog

https://d338mlbnszozgc.cloudfront.net/logos/sentry.svg

Sentry

​
References

https://neon.tech/docs/ai/neon-mcp-server

https://neon.tech/docs/ai/connect-mcp-clients-to-neon

https://github.com/neondatabase-labs/mcp-server-neon