# Neon — MCP server card for AI agents

Official Neon MCP server for managing Neon projects and Lakebase Postgres databases.

Registry name: `com.neon/mcp` · category: Databases · version 2.0.0 · updated 2026-11-05

## Connect
- Remote (Claude Code): `claude mcp add --transport http neon https://mcp.neon.tech/mcp`

## Facts
- Repository: https://github.com/neondatabase/mcp-server-neon (666 stars)
- Website: https://neon.com/docs/ai/neon-mcp-server

Before you connect a server: read its repository, and give it only the permissions and keys it needs.

## Links
- AgentGid page: https://agentgid.com/mcp/servers/com-neon-mcp/


## Neon MCP: manage Neon Postgres databases from your AI assistant

Neon's own connector lets an AI assistant like Claude Code, Cursor or Codex work with your Neon Postgres databases. You ask in plain words, and it creates databases and branches, runs queries and tries schema changes on a temporary copy first. Neon recommends it for development and testing, not for live production data.

### Where to use it
- A database for a new app: Ask your assistant to create a Postgres database and a users table, and it does it in your Neon account. You skip the clicking through dashboards.
- Try a table change on a copy: Adding a column or changing a table first runs on a temporary copy of your database. You check the result, then say yes or no before it touches the main data.
- Let the assistant only read: Give the assistant a read-only connection to one project, so it can look at tables and answer questions about your data but cannot change or delete anything.
- Find out why the app is slow: Ask why your database is slow or large. The assistant runs ready-made checks for slow queries, unused indexes and table sizes instead of guessing.
- Check what the assistant may do: Before you connect, see the exact list of actions a chosen setup gives the assistant. No sign-in is needed for this preview.
- A test copy for each feature: Before building a new feature, ask for a branch of the database, try the changes there, and delete the branch when you are done. (idea, not from the official pages)

### How to start
- Have a Neon account. The first time you connect, a Neon page opens in your browser to approve the assistant.
- Add the hosted server to your assistant. In Claude Code it is one command.

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

- On the approval page, untick Allow writes if the assistant should only read; you can also pick one project there.

### License
The server's code is free and open under the MIT license, also for paid work. Using it means using your Neon account, under Neon's own plans and terms.

### Good to know
- Neon says to use it for development and testing only and never to connect it to production databases.
- With write access it can delete whole projects, branches, databases and users. Read every action before you approve it.
- When you sign in, the server sends your Neon account number, name and email to Neon's analytics, plus the name of each action it runs.
- In read-only mode the assistant cannot get the database password link; copy it from the Neon Console yourself.
- If your project only accepts listed addresses, add Neon's two server addresses, 34.192.103.46 and 23.22.233.166.

Checked 2026-11-10 against: https://github.com/neondatabase/mcp-server-neon/blob/6d5b82aedf224794497710a204e00d8401348025/README.md, https://github.com/neondatabase/mcp-server-neon/blob/6d5b82aedf224794497710a204e00d8401348025/package.json, https://github.com/neondatabase/mcp-server-neon/blob/6d5b82aedf224794497710a204e00d8401348025/LICENSE, https://github.com/neondatabase/mcp-server-neon/blob/6d5b82aedf224794497710a204e00d8401348025/CHANGELOG.md, https://github.com/neondatabase/mcp-server-neon/blob/6d5b82aedf224794497710a204e00d8401348025/mcp/tools/mcp-tool-names.json, https://github.com/neondatabase/mcp-server-neon/blob/6d5b82aedf224794497710a204e00d8401348025/mcp/__tests__/__snapshots__/hosted-tools-catalog.md, https://neon.com/docs/ai/neon-mcp-server.md, https://neon.com/docs/ai/connect-mcp-clients-to-neon.md, https://neon.com/docs/ai/agent-setup/codex.md, https://neon.com/docs/ai/agent-setup/cursor.md, https://neon.com/guides/claude-code-mcp-neon.md

### Mistakes to avoid
- Don't: "url": "https://mcp.neon.tech/sse" → Do: "url": "https://mcp.neon.tech/mcp" (The old SSE address is retired and answers 410 Gone.)
- Don't: Installing the local npm package @neondatabase/mcp-server-neon → Do: Connect to https://mcp.neon.tech/mcp, or bridge with npx -y mcp-remote https://mcp.neon.tech/mcp for stdio-only clients (The local package is deprecated.)
- Don't: Calling run_sql_transaction or get_connection_string on a read-only connection → Do: Use separate run_sql calls for reads; ask the person to copy DATABASE_URL from the Neon Console (Both tools are not available in read-only mode.)
- Don't: Pinning roleName to a role made in the Neon Console to limit what the agent reads → Do: Create the role with SQL and GRANT SELECT only on the tables it may read (Console-made roles belong to neon_superuser and can read all data.)
- Don't: Running complete_database_migration, delete_branch or delete_project without asking → Do: Show the person the change and wait for a yes (The tool descriptions in the server say never to run them on their own.)

### Questions
- Do I need an API key? No. The hosted server signs you in through a Neon page in the browser; an API key is only an option for clients without that sign-in.
- Can it delete my data? Yes, with write access. Tools like delete_project and delete_branch remove data; a deleted project can be recovered within 7 days.
- Can I limit it to one project? Yes. Add projectId to the server address; project-wide tools like list_projects and create_project are then hidden.
- Should I install the npm package @neondatabase/mcp-server-neon? No. The local package is deprecated; connect to the hosted server, or bridge to it with mcp-remote if your client only runs local servers.
- Can it read Neon's documentation without an account? Yes. The docs tools (search_docs and get_doc) work without signing in.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
