Neon MCP Server for Cursor: Setup & Config

What you can do with Neon in Cursor

Choose Neon-native branching and migrations with hosted authentication and project-scoped access.

• Prepare schema migrations using development branches.
• Limit an assistant to read-only queries in a selected project.

Before you start: Neon in Cursor

• A Neon account
• An MCP-compatible client
• Node.js 18+ for the documented command-based setup

This command registers the hosted service with detected clients; it does not launch a local server. Complete OAuth authorization, or use the documented bearer API-key configuration. Production use is not recommended.

Neon Cursor configuration

1. Choose Cursor configuration scope

   For Neon MCP Server, open Project: .cursor/mcp.json User: ~/.cursor/mcp.json. Merge into mcpServers at project or user scope.

2. Add Neon MCP Server to Cursor

   Use the mcp-server-neon-neondatabase-labs entry below in mcpServers. Keep Neon MCP Server's documented http connection fields and your other Cursor entries.

3. Check Neon MCP Server in Cursor

   Neon MCP Server: Enable in Cursor’s MCP settings; inspect tools.

{
  "mcpServers": {
    "mcp-server-neon-neondatabase-labs": {
      "url": "https://mcp.neon.tech/mcp"
    }
  }
}

Neon tools available to Cursor

Neon's stored tool list documents 30 tools; compare it with Cursor's connected tool list, because the stored list is not a live check.

__node_version

Find __node_version under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

list_projects

Find list_projects under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

create_project

Find create_project under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

delete_project

Find delete_project under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

describe_project

Find describe_project under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

run_sql

Find run_sql under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

run_sql_transaction

Find run_sql_transaction under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

describe_table_schema

Find describe_table_schema under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

get_database_tables

Find get_database_tables under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

create_branch

Find create_branch under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

prepare_database_migration

Find prepare_database_migration under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

complete_database_migration

Find complete_database_migration under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

describe_branch

Find describe_branch under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

delete_branch

Find delete_branch under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

get_connection_string

Find get_connection_string under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

provision_neon_auth

Find provision_neon_auth under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Set up Neon project authentication through the documented Stack Auth integration.

list_shared_projects

Find list_shared_projects under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Find Neon projects that have been shared with the current user.

list_organizations

Find list_organizations under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

List organizations available through the connection.

list_branch_computes

Find list_branch_computes under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Inspect compute resources associated with a branch.

compare_database_schema

Find compare_database_schema under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Compare database schemas through the schema tool category.

list_slow_queries

Find list_slow_queries under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Inspect slow-query information for performance investigation.

explain_sql_statement

Find explain_sql_statement under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Inspect how a SQL statement is planned.

search

Find search under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Search through the server's retrieval interface; unavailable with project scoping.

fetch

Find fetch under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Retrieve content through the server's retrieval interface; unavailable with project scoping.

list_docs_resources

Find list_docs_resources under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Discover available documentation resources.

get_doc_resource

Find get_doc_resource under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Retrieve a selected documentation resource.

reset_from_parent

Find reset_from_parent under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Reset a branch from its parent; requires write access.

provision_neon_data_api

Find provision_neon_data_api under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Provision the Neon Data API with write-enabled access.

prepare_query_tuning

Find prepare_query_tuning under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Prepare query tuning through a write-enabled workflow.

complete_query_tuning

Find complete_query_tuning under Neon in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Complete the documented query-tuning workflow with write access.

Neon: full stored tool descriptions

Troubleshooting Neon in Cursor

• Enable Neon MCP Server in Cursor's MCP settings and inspect its tools. For mcp.neon.tech, check reachability, transport, and credential expiry if authentication fails.
• Neon MCP Server: check http connectivity to mcp.neon.tech from Cursor; a stdio command is not a replacement for this endpoint.
• Transport mismatch: Neon's catalog lists stdio; the displayed Cursor configuration uses http.
• Known limitation: The README advises against production use.
• Known limitation: Write-enabled access includes destructive project and branch operations.
• Known limitation: Organization projects require explicit context when using OAuth.
• General Cursor troubleshooting lives in the /clients/cursor guide.

Frequently asked questions