Connect an app to Neon
Ask your assistant to choose a connection method for your runtime or integrate an ORM such as Drizzle. The Postgres guidance covers drivers, connection strings, and pooled versus direct connections.
Overview
The Neon plugin pairs task-specific skills with the Neon MCP Server, helping your coding assistant choose database connections, work with branches, and manage projects or run SQL. The assistant can load a matching skill when you describe a task in natural language; you can also ask it to use a skill explicitly.
The skills also guide application backend work with Auth, Functions, Object Storage, AI Gateway, and Realtime. In Claude Code and Cursor, you can select a skill from the chat’s slash menu to invoke it directly.
Use Cases
Test a database migration
Use the Postgres skill’s branching guidance to choose an isolated test environment: a normal branch for testing with realistic data, or a schema-only branch when production rows must stay out of development.
Investigate high data transfer costs
Ask the Postgres skill to investigate queries that return more data than the application uses. Its workflow connects database statistics with code review, query changes, and a check that data transfer has fallen.
Add login to an application
With the Auth skill installed, ask your assistant to set up Managed Better Auth or assess whether a required feature needs self-managed Better Auth. The skill also guides it to preserve an existing identity provider unless you request a migration.
Build backend features alongside your database
With the relevant platform skills installed, ask your assistant to deploy a Node.js HTTP function, add S3-compatible file storage, or route model calls through Neon AI Gateway.
Components
Skills supply instructions for specific tasks; the Neon MCP Server supplies tools for live database and project operations. The Claude Code and Cursor packages include the skills below and the Neon MCP Server.
Skills
This plugin's skills 7What you’ll need
Showing all 7
Database development
neon
Choose Neon services and get started with an application backend.
neon-postgres
Choose connections and follow Postgres development, branching, and egress optimization guidance.
Application services
neon-auth
Implement Managed Better Auth or assess when self-managed authentication is needed.
neon-functions
Define and deploy Node.js HTTP functions alongside your Neon database.
neon-object-storage
Add S3-compatible file storage that branches with your project.
neon-ai-gateway
Connect model calls through one API and Neon credential.
neon-realtime
Build reactive interfaces and agents that update as database rows change.
No matching results.
MCP servers
1neon
Manage Neon projects and branches, run SQL, and make schema changes.
Also in this repository 1
Installing this plugin does not install these skills.
Install
Install the plugin for your AI tool to get its bundled skills and Neon MCP integration. The skills-only alternatives add guidance without the MCP server or other plugin components.
Claude Code
- 01
In a Claude Code session, add the Neon marketplace.
/plugin marketplace add neondatabase/agent-skills - 02
Install the Neon Postgres plugin in the same session. Choose its installation scope in the plugin panel and follow the installation summary if a reload is needed.
/plugin install neon-postgres@neon - 03
Ask Claude Code which skills it can access. Look for neon-postgres in the response.
When you first use the Neon MCP tools, complete the browser prompts to authorize your Neon account.
This method needs Node.js and installs the plugin at user level across your projects.
- 04
Run this in a terminal to install the plugin for Claude Code at user level. Confirm the installation when prompted.
Neon docs: agent installer combined with the global optionnpx neon@latest plugins --agent claude-code --global - 05
Start a Claude Code session and ask which skills it can access. Look for neon-postgres in the response.
Complete the Neon browser authorization when you first use the plugin's MCP tools.
This installs the repository’s skills without its MCP server or other plugin components. You need Node.js.
Installation scope
- 04
Run this in a terminal from your project directory.
npx skills add neondatabase/agent-skills -y - 05
Open Claude Code in that project and ask which Neon skills it can access.
- 04
Run this in a terminal to install the skills at user level.
npx skills add neondatabase/agent-skills -y -g - 05
Open Claude Code and ask which Neon skills it can access.
This installs selected skills into the current project without the MCP server or other plugin components. You need the Neon CLI.
- 04
From your project directory, run the skill installer in a terminal. Select Claude Code and the Neon skills you want, then confirm.
neon skills - 05
Open Claude Code in that project and ask which Neon skills it can access.
You need Node.js and the Neon CLI. VS Code requires a user-level plugin installation.
- 04
Run the installer in a terminal. Select VS Code in the agent picker and confirm the installation.
neon plugins --global - 05
In VS Code, open the Command Palette and choose Chat: Open Customizations. Under Plugins, confirm that Neon is listed and enabled for the intended harness and workspace.
- 06
Start a fresh chat session with that harness and workspace, and confirm that the Neon components you need are available.
- 04
With the Antigravity CLI available, run this in a terminal to install the Neon plugin from its repository.
agy plugin install https://github.com/neondatabase/agent-skills - 05
In Antigravity, open the MCP manager, select the Neon MCP server, and complete the OAuth prompts to authorize your Neon account.
/mcp - 06
Run this in a terminal and confirm that Antigravity lists the Neon plugin, its skills, and the MCP server.
agy plugin list
This installs the plugin at user level for local sessions in Claude Desktop’s Code tab. You need Node.js and the Neon CLI. Desktop chat and Cowork get plugins from Customize > Plugins; this CLI installation does not add the plugin to either.
- 04
Run the installer in a terminal. Select Claude Desktop in the agent picker and confirm the user-level installation. The installer uses the claude-code target for the Code tab.
neon plugins --global - 05
Start a new local session in Claude Desktop’s Code tab. Type / in the prompt box and look for the Neon skills under neon-postgres.
When you first use the Neon MCP tools, complete the browser prompts to authorize your Neon account.
You need Node.js and the Neon CLI. GitHub Copilot CLI requires a user-level plugin installation.
- 04
Run the installer in a terminal. Select GitHub Copilot CLI in the agent picker and confirm the installation.
neon plugins --global - 05
Start a GitHub Copilot CLI session and ask which skills are available. Look for the installed Neon skills.
- 04
Open Cursor chat and install the Neon Postgres plugin.
/add-plugin neon-postgres - 05
Ask Cursor to “Get started with Neon” and complete the authentication prompts to connect your Neon account.
This method needs Node.js and installs the plugin at user level across your projects.
- 04
Run this in a terminal to install the plugin for Cursor at user level. Confirm the installation when prompted.
Neon docs: agent installer combined with the global optionnpx neon@latest plugins --agent cursor --global - 05
Start Cursor. In Agent chat, type / and look for the installed Neon skills.
This installs the repository’s skills without its MCP server or other plugin components. You need Node.js.
Installation scope
- 04
Run this in a terminal from your project directory.
npx skills add neondatabase/agent-skills -y - 05
Start Cursor in that project. In Agent chat, type / and look for the installed Neon skills.
- 04
Run this in a terminal to install the skills at user level.
npx skills add neondatabase/agent-skills -y -g - 05
Start Cursor. In Agent chat, type / and look for the installed Neon skills.
This installs selected skills into the current project without the MCP server or other plugin components. You need the Neon CLI.
- 04
From your project directory, run the skill installer in a terminal. Select Cursor and the Neon skills you want, then confirm.
neon skills - 05
Start Cursor in that project. In Agent chat, type / and look for the installed Neon skills.
- 04
In the Codex app, open Plugins, find Neon, and choose Add to Codex. In the Codex CLI, open the plugin list, select Neon, and choose Add to Codex.
- 05
Follow any authentication prompts to connect your Neon account.
- 06
Start a new thread and type @ to check that you can select the Neon plugin or one of its bundled skills.
This method needs Node.js and installs the plugin at user level across your projects.
- 04
Run this in a terminal to install the plugin for Codex at user level. Confirm the installation when prompted.
Neon docs: agent installer combined with the global optionnpx neon@latest plugins --agent codex --global - 05
In Codex, follow any authentication prompts, then start a new thread and type @ to look for Neon or its bundled skills.
This installs the repository’s skills without its MCP server or other plugin components. You need Node.js.
Installation scope
- 04
Run this in a terminal from your project directory.
npx skills add neondatabase/agent-skills -y - 05
Open that project in the Codex app and look for the Neon skills in the skill selector. If newly installed skills do not appear, restart Codex.
- 04
Run this in a terminal to install the skills at user level.
npx skills add neondatabase/agent-skills -y -g - 05
Open the Codex app and look for the Neon skills in the skill selector. If newly installed skills do not appear, restart Codex.
This installs selected skills into the current project without the MCP server or other plugin components. You need the Neon CLI.
- 04
From your project directory, run the skill installer in a terminal. Select Codex and the Neon skills you want, then confirm.
neon skills - 05
Open that project in the Codex app and look for the Neon skills in the skill selector. If newly installed skills do not appear, restart Codex.
You need Node.js and the Neon CLI. Grok Build requires a user-level plugin installation.
- 04
Run the installer in a terminal. Select Grok Build in the agent picker and confirm the installation.
neon plugins --global - 05
In Grok Build, open the extensions modal and check that the Neon plugin, its skills, and its MCP server are listed.
- 04
In Kimi Code CLI chat, install the plugin from its repository.
/plugins install https://github.com/neondatabase/agent-skills - 05
Start a new Kimi Code session to load the plugin changes. In its help view, check that the Neon skills appear among the loaded skills.
You need Node.js and the Neon CLI. Kimi Code requires a user-level plugin installation through this installer.
- 04
Run the installer in a terminal. Select Kimi Code in the agent picker and confirm the installation.
neon plugins --global - 05
Start a new Kimi Code session to load the plugin changes. In its help view, check that the Neon skills appear among the loaded skills.
With Pi installed, choose one source for the Neon skills. These methods install skills only, without the Neon MCP Server.
Package source
- 04
Run this in a terminal to install the Neon skills from npm.
pi install npm:@neon/skills
- 04
Run this in a terminal to install the skills directly from the repository. Pi reads its skills directory without a separate sync step.
pi install git:github.com/neondatabase/agent-skills
- 04
Following Pi’s package instructions, start Pi, or enter
/reloadin a running session to load the installed skills. - 05
Type
/in Pi and look for the Neon skills in the command menu. In a terminal, runpi listto confirm that the Neon package is configured.
- 04
In Grok Bot, open Connect apps from the sidebar and search for Neon.
- 05
Add the Neon app and complete the authorization prompts for your Neon account.
- 06
Confirm that Neon appears under Installed and that you have completed sign-in. Its tools are ready from your next message.