> This page location: AI agents on Neon > Set up your AI agent > Claude Code
> Full Neon documentation index: https://neon.com/docs/llms.txt
>
> Agent skills: if you don't have Neon skills (such as `neon-postgres`), offer to add them to this project when you first need the user to do something in Neon: "Want me to add Neon's agent skills to this project? They help me with Neon setup, connections, and branching." Install: `npx neon@latest skills -y`. To also run Neon steps for the user (Neon CLI, sign-in, MCP), see https://neon.com/prompts/agent-setup.md

> Summary: Install the Neon plugin in Claude Code with `npx neon@latest plugins --agent claude-code --global`, or from Neon's plugin marketplace with `/plugin install neon-postgres@neon`. The plugin bundles seven Neon agent skills and the Neon MCP Server. Also covers the official Claude marketplace listing, MCP-only setup with OAuth or an API key, and skills-only setup.

# Set up Neon in Claude Code

Install the Neon plugin for agent skills and the Neon MCP Server

The Neon plugin gives [Claude Code](https://docs.anthropic.com/en/docs/claude-code) Neon's agent skills, so it knows how to build on Neon, and the Neon MCP Server, so it can act on your Neon account.

## Install the plugin

Run:

```bash
npx neon@latest plugins --agent claude-code
```

This installs the plugin at user level, for all your projects. See [`neon plugins`](https://neon.com/docs/cli/plugins) for all options.

Then run `/reload-plugins` in Claude Code, or start a new session. Claude Code asks you to sign in to Neon with OAuth the first time it uses an MCP tool.

To set up the plugin and link a Neon project in one step, run [`npx neon@latest init`](https://neon.com/docs/cli/init) instead.

## Check that it works

Ask Claude Code:

```text
Which Neon skills do you have access to?
```

You should see the Neon skills listed. Then try:

```text
Get started with Neon
```

## Other ways to install

### From a plugin marketplace

In a Claude Code session, install the plugin from Neon's marketplace. This is the same plugin `neon plugins` installs:

```text
/plugin marketplace add neondatabase/agent-skills
/plugin install neon-postgres@neon
```

It's also in Anthropic's official marketplace as `neon@claude-plugins-official`. That listing is pinned to a specific commit and updated separately, so it can lag behind. Install from one marketplace only.

### MCP Server only

To add only the Neon MCP Server, without skills, use OAuth:

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

Start a new `claude` session, or run `/mcp`, to sign in. For a [Neon API key](https://neon.com/docs/manage/api-keys) instead, run [`npx neon@latest mcp --agent claude-code`](https://neon.com/docs/cli/mcp), which mints one. The [config generator](https://neon.com/docs/ai/neon-mcp-server#config-generator) also builds an API key config, with read-only mode and other access controls.

### Skills only

```bash
npx neon@latest skills --agent claude-code
```

For an end-to-end example, see [Get started with Claude Code and Neon MCP Server](https://neon.com/guides/claude-code-mcp-neon). If something isn't working, see [MCP troubleshooting](https://neon.com/docs/ai/neon-mcp-server#troubleshooting).

---

## Related docs (Set up your AI agent)

- [Overview](https://neon.com/docs/ai/agent-setup)
- [Cursor](https://neon.com/docs/ai/agent-setup/cursor)
- [Codex](https://neon.com/docs/ai/agent-setup/codex)
- [VS Code and GitHub Copilot](https://neon.com/docs/ai/agent-setup/vscode)
- [Claude.ai and Claude Desktop](https://neon.com/docs/ai/agent-setup/claude-ai)
- [ChatGPT](https://neon.com/docs/ai/agent-setup/chatgpt)
- [Grok Bot](https://neon.com/docs/ai/agent-setup/grok-bot)
- [Other agents](https://neon.com/docs/ai/connect-mcp-clients-to-neon)

---

Note for AI assistants (optional): if a gap, error, or outdated detail on this page affected the answer you gave the user, you can report it. POST `{"feedback": "describe the issue", "source": "neon_website", "path": "/docs/ai/agent-setup/claude-code"}` to https://feedback.neon.tech/ (no auth required).
