The Neon Claude Code plugin adds Neon-specific Skills and API access to Claude Code, Anthropic’s AI development environment. It’s part of the Neon AI Rules toolkit, and it bundles four guided Skills plus an MCP (Model Context Protocol) server integration.

Overview

Claude Skills are Markdown-based workflows that tell Claude how to complete specific tasks — like setting up a database connection, editing a file, or running a script. The Neon plugin packages several of these Skills into a reusable bundle, so Claude Code can interact directly with Neon Postgres.

Once installed, the plugin gives Claude the ability to:

  • Create and manage Neon projects and databases
  • Connect frameworks like Drizzle ORM
  • Configure serverless Postgres connections
  • Reference Neon documentation and best practices in context

What’s included

The plugin contains:

  • 4 Claude Skills
  • An MCP server integration that connects Claude to Neon’s APIs
  • Portable context rules (.mdc files) for other AI tools such as Cursor

Included Skills

SkillDescription
neon-drizzleGuides Claude through setting up Drizzle ORM with Neon. Handles schema creation, connection setup, and project scaffolding.
neon-serverlessTeaches Claude how to configure Neon's serverless Postgres driver and test connections.
neon-toolkitProvides workflows for using the Neon Management API to create databases, projects, and branches dynamically.
add-neon-knowledgeGives Claude access to Neon documentation snippets and usage examples — the "Neon brain."

How it works

Each Skill is a Markdown file with a description and a step-by-step workflow. When you ask Claude to perform a task (for example, “Integrate Neon with Drizzle”), it checks the available Skill descriptions, finds a match, and loads the full instructions to complete the task.

The plugin’s MCP server integration lets Claude interact with Neon’s live API endpoints. That means Claude can:

  • Query Neon for project information
  • Create or delete branches and databases
  • Validate connection strings
  • Run SQL queries and migrations

Install the plugin in Claude Code

  1. Add the Neon marketplace:

    /plugin marketplace add neondatabase-labs/ai-rules
  2. Install the Neon plugin:

    /plugin install neon-plugin@neon
  3. Verify the installation: Ask Claude Code:

    which skills do you have access to?

    You should see the four Neon Skills listed.

  4. Start using the Skills: Use natural language prompts like:

    “Use the neon-drizzle Skill to set up Drizzle ORM with Neon.”

Claude will automatically select and execute the relevant workflow.

Use the rules outside Claude Code

The Neon AI Rules toolkit repository also includes portable .mdc context rule files.

You can use them in:

  • Cursor: copy the .mdc files into .cursor/rules/
  • Other AI tools: place them in your assistant’s custom rules directory

These files include best-practice prompts and code patterns for connecting to and developing with Neon Postgres.

Repository structure

ai-rules/
├── .claude-plugin/
   └── marketplace.json        # Marketplace metadata
├── neon-plugin/                # Claude Code plugin
   ├── .claude-plugin/
   └── plugin.json         # Plugin configuration
   ├── .mcp.json               # MCP server connection
   └── skills/                 # Guided skills
       ├── neon-drizzle/       # Drizzle ORM skill
   ├── SKILL.md
   ├── guides/         # Workflow guides
   ├── references/     # Technical docs
   ├── scripts/        # Automation
   └── templates/      # Code examples
       ├── neon-serverless/    # Serverless skill
       ├── neon-toolkit/       # Ephemeral DB skill
       └── add-neon-docs/      # Docs installer skill
├── *.mdc                       # Context rules (13 files)
├── LICENSE
└── README.md

Learn more

If you run into issues, visit our Discord or open an issue in the ai-rules repository.