PluginInstalls cleanly

Add a Postgres database with Neon

Neon Agent Skills

Neon's official skills and connector help your assistant create a Postgres database, add user sign-in and test changes on a safe copy of your data.

Works with
Claude Code, Codex CLI, Gemini CLI
Good for
Build an app

What it does

Neon is a service that runs Postgres databases for you. A database is where an app keeps its data, such as users, orders or notes. This is Neon's own package, version 2.3.0: nine skills (instruction files) plus Neon's connector (an MCP server, a bridge to another service).

The skills teach your assistant how to set up a Neon database, add sign-in for your users (Neon Auth), store files, run small server functions and make queries that update live. One skill explains branches: a branch is a copy of your database that you can change and test without touching the real one.

In Claude Code the connector lets the assistant create and delete projects and branches, deploy functions and run database commands after you sign in to Neon in the browser. In Codex and Gemini CLI the npx lines install the skills only.

Things to know before you start:

  • Neon recommends the connector for development and testing only. Do not connect it to a production database or to personal data (Neon MCP docs).
  • The neon skill may install the Neon CLI (npm i -g neon) and run neon mcp. That command saves a Neon API key in your coding tool's settings. With -y and no --agent, it writes the key into every coding tool installed on your computer (neon SKILL.md).
  • neon env pull writes your database address and password into a .env file in your project. Do not share that file.
  • The Neon CLI sends anonymous usage data and error reports. Turn it off with --no-analytics (Neon CLI docs).
  • npx skills is a third-party installer (vercel-labs/skills). It also sends anonymous usage data. Turn it off with DISABLE_TELEMETRY=1 or DO_NOT_TRACK=1 (skills README).

We installed the Claude Code plugin in our sandbox. We did not run the two npx lines for Codex and Gemini CLI there.

Who it is for

People who build an app with an AI assistant and need a place to keep its data, without running a database server themselves.

Example prompts

  • "Set up a Neon Postgres database for this app and add the connection string to my .env file."
  • "Create a Neon branch so I can test this database change safely."
  • "Add email and password sign-in with Neon Auth."
  • "Why is my Neon bill high? Check this code for queries that fetch too much data."
  • "Show me the tables in my Neon database."

How to install

/plugin marketplace add neondatabase/agent-skills
/plugin install neon-postgres@neon
npx skills add neondatabase/agent-skills -a codex
npx skills add neondatabase/agent-skills -a gemini-cli

How to use it

In Claude Code, sign in to Neon in the browser the first time a Neon tool runs. Then ask: Set up a Neon Postgres database for this app. Or: Create a branch so I can test this migration.

Check it works

  1. In Claude Code, run /plugin and look for neon-postgres or neon. The plugin's own file names it neon, so the list may show either name.
  2. Ask about your Neon projects. The first Neon tool call opens a browser page to sign in to Neon (README).
  3. For the npx install, look for the neon folders in your agent's skills folder.

Common problems

  • A command waits for you — "Awaiting authentication in web browser" — the skill tells the assistant to stop and ask you to sign in with neon login (or neon auth). Finish the sign-in in your browser (neon SKILL.md).
  • Functions, file storage, AI Gateway or Realtime refuse to work on a project made without an account — requires_claim — claim the project in Neon first (neon SKILL.md).
  • The assistant changes data you wanted to keep — no error text — use the read-only address https://mcp.neon.tech/mcp?readonly=true (Neon MCP docs).

What to watch out for

  • The Neon connection can create and delete projects and branches, deploy functions and run SQL on your databases (Neon MCP docs); read each action before you approve it
  • Neon recommends the connector for development and testing only, never for production databases or personal data (Neon MCP docs); add ?readonly=true to the address or pick read-only during sign-in to block changes
  • The neon skill may install the Neon CLI and run neon mcp, which saves a Neon API key in your coding tool's settings; it also pulls database passwords into .env files (neon SKILL.md)
  • The Neon CLI and the npx skills installer both send anonymous usage data; turn them off with neon --no-analytics and DISABLE_TELEMETRY=1 (Neon CLI docs, skills README)
  • Projects made without an account (Claimable Neon) expire after 72 hours unless you claim them (neon SKILL.md)
  • npx skills is a third-party installer (vercel-labs/skills) that copies the skill files into your agent's folder

Licence and author

Licence
Apache-2.0
Author
Neon
Source code
github.com/neondatabase/agent-skills

How we tested it

We installed it on an empty test computer on 17 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.

Test level

Not yet used on real work.

Technical details of the test
Date
17 Oct 2026
Method
Intake sandbox run on 2026-10-17 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files, ran "npx -y skills --help"; installed neon-postgres@neon with the Claude Code command line.

Checked again on 17 Oct 2026

Alternatives

  • pg-aiguide — Postgres advice and docs search, without a hosted database service.
  • DuckDB skills — local data files and quick analysis, no server needed.
  • Railway plugin — hosts your app and can add a database next to it.

FAQ

Do I need a Neon account? Not to try it. Claimable Neon makes a project without one, but it expires after 72 hours unless you claim it (neon SKILL.md).

Is it in Anthropic's directory? Yes, as neon, but it is pinned to version 2.0.1 (September 2026), without the Realtime skill. The lines above install neon-postgres 2.3.0 from Neon's own marketplace.

Can I keep it from changing my data? Yes. Add ?readonly=true to the connector address or pick read-only during sign-in. Neon's docs also describe a mode that limits it to one project (?projectId=<id>).

Does it cost money? The README names no price. Neon's own plans apply to the databases you create.

Sources