Skip to content

Development integration

Neon MCP server for Claude, Codex and Cursor

Manage Neon Postgres projects, branches and queries. Connect the Neon MCP server to Toolstile once, then choose which of its tools Claude Code, Codex, Cursor and Claude Desktop may use.

Free plan available. Server credentials stay in Toolstile, not in agent configs.

On this page

What your AI apps can do with Neon

  • Create projects and branches
  • Run SQL and plan migrations

Neon MCP tools

127 tools, taken from the publisher's documentation on 29 October 2026. The server decides what it offers and can add or rename tools at any time; after you connect, Toolstile shows the current list.

ToolWhat it does
list_organizationsList all organizations the current user belongs to
run_sqlExecute one SQL statement on a Neon database
run_sql_transactionExecute multiple SQL statements as one transaction
describe_table_schemaGet column definitions, data types, and constraints for a specific table
get_database_tablesList all tables in a Neon database
prepare_database_migrationApply a schema change on a temporary branch and return a migration_id
complete_database_migrationApply or discard a prepared migration and delete the temporary branch
describe_branchGet a tree view of all objects in a branch, including databases, schemas, tables, views, and
get_connection_stringGet a PostgreSQL connection string for a Neon database
get_neon_auth_configRead Neon Auth config for a branch with OAuth and SMTP secrets redacted as "***redacted***"
explain_sql_statementGenerate the execution plan for a SQL statement
prepare_query_tuningAnalyze a slow query on a temporary branch and return a tuning_id
complete_query_tuningApply or discard query-tuning changes and delete the temporary branch
list_slow_queriesList queries from pg_stat_statements by execution time, slowest first
inspect_databaseRun one read-only neon inspect db check (pick check from the input schema)
searchSearch across all organizations, projects, and branches by keyword
fetchFetch detailed information about a specific organization, project, or branch using the ID
search_docsSearch neon.com: docs, API reference, PostgreSQL tutorial, guides, FAQs, changelog, and blog
get_docFetch one neon.com page as markdown
send_feedbackSend anonymous feedback about Neon or this MCP server to the Neon team
list_projectsList Neon projects you own
describe_projectRetrieves the project record (settings, compute, usage)
create_projectCreates a Neon project and waits until the default compute is ready
update_projectUpdates the specified project
delete_projectDelete a Neon project and all its data
recover_projectRecovers a deleted project within the 7-day deletion recovery period
list_project_permissionsRetrieves details about users who have access to the project, including the permission id, the
list_project_membersLists organization members and their per-project roles for an org-owned project
list_regionsLists Neon regions available to the authenticated account
list_operationsLists operations for a project
get_operationRetrieves details for the specified operation
list_branchesRetrieves a list of branches for the specified project
get_branchRetrieves information about the specified branch
create_branchCreates a branch with a read-write compute and waits until it is ready
update_branchUpdates the specified branch
delete_branchDelete a branch and all its data
get_default_branchResolve the project's default branch by the default flag, not by name
set_default_branchSets the specified branch as the project's default branch
reset_from_parentReset a branch to its parent's current HEAD
compare_database_schemaCompare one database's SQL schema on a branch to another
finalize_branch_restoreFinalize a branch created with restore_snapshot and finalize: false: reassign computes (this
list_postgres_rolesRetrieves a list of Postgres roles from the specified branch
get_postgres_roleRetrieves details about the specified role
create_postgres_roleCreates a Postgres role in the specified branch
delete_postgres_roleDeletes the specified Postgres role from the branch
reset_postgres_role_passwordResets the password for the specified Postgres role
list_postgres_databasesRetrieves a list of databases for the specified branch
get_postgres_databaseRetrieves information about the specified database
create_postgres_databaseCreates a database in the specified branch
update_postgres_databaseUpdates the specified database in the branch
delete_postgres_databaseDeletes the specified database from the branch
list_postgres_endpointsRetrieves a list of compute endpoints for the specified project
list_branch_computesRetrieves a list of compute endpoints for the specified branch
get_postgres_endpointRetrieves information about the specified compute endpoint
create_postgres_endpointCreates a compute endpoint on a branch
update_postgres_endpointUpdates the specified compute endpoint
delete_postgres_endpointDeletes the specified compute endpoint
start_postgres_endpointStarts a compute endpoint
suspend_postgres_endpointSuspends the specified compute endpoint
restart_postgres_endpointRestarts the specified compute endpoint by immediately suspending it and then starting it again
list_snapshotsLists the snapshots for the specified project
get_snapshot_scheduleReturns the backup schedule for the specified branch, including the configured snapshot frequencies
set_snapshot_scheduleReplace a branch's automatic snapshot schedule
create_snapshotCreates a snapshot from the specified branch
update_snapshotUpdates the specified snapshot
delete_snapshotDeletes the specified snapshot
restore_snapshotRestore a snapshot onto a new or existing branch
get_authRetrieves the Neon Auth integration details for the specified branch, including the auth
provision_neon_authEnables Neon Auth for the specified branch by connecting it to an authentication provider
disable_authDisables the Neon Auth integration for the specified branch, removing the connection to the
update_auth_configUpdates the auth configuration for the branch
list_auth_oauth_providersLists the social login providers (Google, GitHub, Microsoft, Vercel) configured for the branch's
add_auth_oauth_providerAdds a social login provider (Google, GitHub, Microsoft, Vercel) that users sign in with to the
update_auth_oauth_providerUpdates a social login provider (Google, GitHub, Microsoft, Vercel) that users sign in with on
delete_auth_oauth_providerDeletes a social login provider (Google, GitHub, Microsoft, Vercel) from the branch's Neon Auth
list_auth_trusted_domainsLists the trusted domains in the redirect URI whitelist for the specified branch
add_auth_trusted_domainAdds a domain to the redirect URI whitelist for the specified branch
delete_auth_trusted_domainRemoves a domain from the redirect URI whitelist for the specified branch
create_auth_userCreates a new user in the Neon Auth user directory for the specified branch
delete_auth_userDeletes the specified user from the Neon Auth user directory for the specified branch
update_auth_user_roleUpdates the role of a user in the Neon Auth user directory for the specified branch
get_auth_oauth_serverRetrieves how Neon Auth acts as an OAuth 2.1 authorization server for the branch, including for
update_auth_oauth_serverConfigures Neon Auth as an OAuth 2.1 authorization server for the branch, including for MCP servers
list_auth_oauth_clientsLists the OAuth clients registered with the branch's Neon Auth OAuth server (apps and MCP
get_auth_oauth_clientReturns an OAuth client registered with the branch's Neon Auth OAuth server
create_auth_oauth_clientRegisters an OAuth client with the branch's Neon Auth OAuth server
update_auth_oauth_clientUpdates an OAuth client of the Neon Auth OAuth server
delete_auth_oauth_clientDeletes an OAuth client from the Neon Auth OAuth server
rotate_auth_oauth_client_secretGenerates a new secret for a confidential client of the Neon Auth OAuth server
get_data_apiRetrieves the Neon Data API configuration for the specified branch, including endpoint URL,
provision_neon_data_apiCreates a new instance of Neon Data API in the specified branch
update_data_apiUpdates the Neon Data API configuration for the specified branch
delete_data_apiDeletes the Neon Data API for the specified branch
query_logsReturns logs for a branch
list_log_fieldsLists the low-cardinality log fields observed on this branch
list_log_field_valuesLists distinct values for a low-cardinality log field
get_ai_gatewayReturns the AI Gateway endpoint host for the specified branch, used to render code-snippet base URLs
list_functionsLists functions on the specified branch
get_functionReturns the function identified by its slug
update_functionUpdates the function's mutable metadata — currently only the display name
delete_functionDeletes the function identified by its slug
deploy_functionCreates a deployment for the function
list_functions_custom_domainsLists all custom domains registered on the branch, across every target entity
register_functions_custom_domainRegisters a hostname on the branch and routes it to a function
delete_functions_custom_domainRemoves a custom domain registered on the branch and stops routing it
list_triggersLists the complete project-bounded set of triggers visible on the branch, ordered by trigger_id
get_triggerReturns the trigger visible on the branch
create_triggerCreates a trigger for a Function visible on the branch
update_triggerApplies a partial update
delete_triggerDeletes a branch-local trigger or writes a branch-local tombstone for an inherited trigger so it
list_credentialsReturns metadata for customer-issued credentials on the branch
create_credentialIssues a new scoped service credential anchored to the specified branch
revoke_credentialSoft-deletes the credential
rotate_credentialReplaces the secret material on an existing scoped credential in place
get_storageReturns whether branchable object storage is usable for the specified branch
list_storage_bucketsLists branchable object storage buckets visible on the specified branch, including those
create_storage_bucketCreates a new branchable object storage bucket on the specified branch
delete_storage_bucketDeletes the named bucket from the specified branch
list_storage_objectsLists objects visible in the named bucket on the specified branch, including those inherited
delete_storage_objectDeletes the named object from the bucket on the specified branch
delete_storage_objects_by_prefixSoft-deletes every object on the specified branch whose key starts with prefix, in a single call
presign_storage_objectReturns a presigned URL that transfers bytes directly to or from the object's bucket on the
get_realtimeRetrieves whether Realtime is enabled for the branch, whether a change is still being applied,
enable_realtimeEnables Realtime for the branch, or applies new options to an enabled branch
disable_realtimeDisables Realtime for the branch and discards its shared secret
get_realtime_secretRetrieves the secret the application backend issues Realtime tokens with
rotate_realtime_secretReplaces the branch's Realtime shared secret and waits until the change is applied

Suggested access for each AI app

The documentation this list comes from doesn't mark Neon's tools as read-only or destructive. Read each tool's description and decide per app before allowing it.

Coding agent in Claude Code or Cursor. Allow the read tools so the agent can look things up without stopping, and require approval for tools that change shared data.

Chat or research app in Claude Desktop. Allow reading and searching. Allow writes only where you want the app to act for you.

Unattended agent, such as a scheduled Codex job. No one is watching the session, so keep it narrow: allow what the job needs, require approval for changes and block the rest.

Blocked tools are removed from the tool list an app sees, so it won't try them. Because rules apply per app, the same Neon connection can be broad in one app and read-only in another, and the credential stays in Toolstile instead of each app's config file.

How it works with Toolstile

  1. Connect once. Add Neon to a workspace (browser sign-in). Toolstile keeps the credential, so no agent config holds it.
  2. Choose access per app. Give Claude Code every Neon tool, give Cursor only the read tools, or keep Neon away from an app entirely.
  3. Share approved accounts. Teammates use the connection without copying tokens, and you can remove access in one place.
  4. Review activity. See which app called which tool and when, so you can tighten access with evidence.

Add the Neon MCP server to an AI app

Through Toolstile, every AI app uses one gateway entry, whichever servers you connect. In Claude Code:

Shell
claude mcp add --transport http toolstile 'https://mcp.toolstile.com/mcp'

Then connect Neon in your workspace and choose which of its tools that app may use. Client setup covers Codex, Cursor and Claude Desktop.

To connect directly instead, add the Neon endpoint to each app separately. In Claude Code:

Shell
claude mcp add --transport http neon 'https://mcp.neon.tech/mcp'

In Cursor's mcp.json:

JSON
{
  "mcpServers": {
    "neon": {
      "url": "https://mcp.neon.tech/mcp"
    }
  }
}

Some servers accept only clients they have approved, or need a token header. Check the Neon MCP documentation for what your client needs.

Before you connect

A Neon account. Sign-in uses your Neon permissions.

Server details

DetailValue
PublisherNeon
Endpointhttps://mcp.neon.tech/mcp
AuthenticationBrowser sign-in
CategoriesDevelopment, Data & infrastructure
Tool list127 tools, observed 29 October 2026 (docs)

Neon MCP documentation