> This page location: AI agents on Neon > Set up your AI agent > Other agents > 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: Set up Neon in AI agents and MCP clients that don't have their own setup page, including Antigravity, Cline, Devin Desktop, fx, Gamut, Gemini CLI, Grok Build, Jules, Kimi Code, Kiro, Pi, and Zed. Install agent skills and the hosted Neon MCP Server (https://mcp.neon.tech/mcp) with the Neon CLI or add-mcp, or configure the server by hand with OAuth or an API key. # Set up other agents and MCP clients Install Neon's agent skills and the Neon MCP Server in Devin Desktop, Cline, Zed, Gemini CLI, Kiro, Kimi Code, and other agents Last updated: 2026-11-05 This page covers agents and MCP clients that don't have their own setup page. If you use Claude Code, Cursor, Codex, VS Code, Claude.ai, ChatGPT, or Grok Bot, start from [Set up your AI agent](https://neon.com/docs/ai/agent-setup) instead. **Important: Security** The Neon MCP Server is intended for **development and testing only**. Always review LLM-requested actions before execution. See [MCP security guidance](https://neon.com/docs/ai/neon-mcp-server#mcp-security-guidance). ## Install for any supported agent Most agents get Neon's [agent skills](https://neon.com/docs/ai/agent-skills) and the [Neon MCP Server](https://neon.com/docs/ai/neon-mcp-server) as two installs. From your project directory, run: ```bash npx neon@latest skills --agent npx neon@latest mcp --agent ``` Replace `` with your agent's ID; `neon skills --help` and `neon mcp --help` list the IDs each command accepts. [`neon mcp`](https://neon.com/docs/cli/mcp) mints a Neon API key by default; pass `--oauth` to sign in on first use instead. To write only the MCP config, use [add-mcp](https://github.com/neondatabase/add-mcp), the tool the Neon CLI uses to patch each agent's MCP config: ```bash npx add-mcp https://mcp.neon.tech/mcp -a ``` Add `-g` for user-level config instead of project-level, then restart your agent. On first use, an OAuth window opens to authorize; for API key auth, add `--header "Authorization: Bearer $NEON_API_KEY"`. ## Supported agents (add-mcp) Run `npx add-mcp list-agents` for the live list from your installed version. As of [add-mcp](https://github.com/neondatabase/add-mcp) 2.6.0, `--agent` values include: | Assistant | `--agent` | Setup | | :------------------------ | :------------------- | :---------------------------------------------------------------------------------------------------------- | | Antigravity | `antigravity` | [Antigravity](https://neon.com/docs/ai/connect-mcp-clients-to-neon#antigravity) | | Claude Code | `claude-code` | [Claude Code page](https://neon.com/docs/ai/agent-setup/claude-code) | | Claude Desktop | `claude-desktop` | [Claude.ai and Claude Desktop page](https://neon.com/docs/ai/agent-setup/claude-ai) | | Cline (VS Code extension) | `cline` | [Cline](https://neon.com/docs/ai/connect-mcp-clients-to-neon#cline-vs-code-extension) | | Cline CLI | `cline-cli` | [Cline](https://neon.com/docs/ai/connect-mcp-clients-to-neon#cline-vs-code-extension) | | Codex | `codex` | [Codex page](https://neon.com/docs/ai/agent-setup/codex) | | Cursor | `cursor` | [Cursor page](https://neon.com/docs/ai/agent-setup/cursor) | | Factory Droid | `factory-droid` | [Any supported agent](https://neon.com/docs/ai/connect-mcp-clients-to-neon#install-for-any-supported-agent) | | fx | `fx` | [fx](https://neon.com/docs/ai/connect-mcp-clients-to-neon#fx) | | Gemini CLI | `gemini-cli` | [Any supported agent](https://neon.com/docs/ai/connect-mcp-clients-to-neon#install-for-any-supported-agent) | | GitHub Copilot CLI | `github-copilot-cli` | [VS Code page](https://neon.com/docs/ai/agent-setup/vscode) | | Goose | `goose` | [Any supported agent](https://neon.com/docs/ai/connect-mcp-clients-to-neon#install-for-any-supported-agent) | | Grok Build | `grok-build` | [Grok Build](https://neon.com/docs/ai/connect-mcp-clients-to-neon#grok-build) | | Hermes Agent | `hermes` | [Any supported agent](https://neon.com/docs/ai/connect-mcp-clients-to-neon#install-for-any-supported-agent) | | Junie | `junie` | [Any supported agent](https://neon.com/docs/ai/connect-mcp-clients-to-neon#install-for-any-supported-agent) | | Kilo Code | `kilo-code` | [Any supported agent](https://neon.com/docs/ai/connect-mcp-clients-to-neon#install-for-any-supported-agent) | | Kimi Code | `kimi-code` | [Kimi Code](https://neon.com/docs/ai/connect-mcp-clients-to-neon#kimi-code) | | Kiro CLI | `kiro-cli` | [Kiro](https://neon.com/docs/ai/connect-mcp-clients-to-neon#kiro) | | Mastra Code | `mastracode` | [Any supported agent](https://neon.com/docs/ai/connect-mcp-clients-to-neon#install-for-any-supported-agent) | | MCPorter | `mcporter` | [Any supported agent](https://neon.com/docs/ai/connect-mcp-clients-to-neon#install-for-any-supported-agent) | | OpenCode | `opencode` | [Any supported agent](https://neon.com/docs/ai/connect-mcp-clients-to-neon#install-for-any-supported-agent) | | Pi | `pi` | [Pi](https://neon.com/docs/ai/connect-mcp-clients-to-neon#pi) | | VS Code | `vscode` | [VS Code page](https://neon.com/docs/ai/agent-setup/vscode) | | Windsurf | `windsurf` | [Devin Desktop](https://neon.com/docs/ai/connect-mcp-clients-to-neon#devin-desktop) | | Zed | `zed` | [Zed](https://neon.com/docs/ai/connect-mcp-clients-to-neon#zed) | **Aliases:** `cline-vscode` → `cline`, `droid`/`factory` → `factory-droid`, `gemini` → `gemini-cli`, `github-copilot` → `vscode`, `grok` → `grok-build`, `hermes-agent` → `hermes`, `kilo`/`kilocode` → `kilo-code`, `kimi` → `kimi-code`, `kiro` → `kiro-cli`, `mastra` → `mastracode`, `pi-agent` → `pi`, `codeium`/`cascade` → `windsurf`. Config paths differ by agent and by project vs global (`-g`); see the [add-mcp README](https://github.com/neondatabase/add-mcp#supported-agents). ## Agents with their own page ### ChatGPT See [Set up Neon in ChatGPT](https://neon.com/docs/ai/agent-setup/chatgpt). ### Claude Code See [Set up Neon in Claude Code](https://neon.com/docs/ai/agent-setup/claude-code). ### Claude Desktop See [Set up Neon in Claude.ai and Claude Desktop](https://neon.com/docs/ai/agent-setup/claude-ai). ### Codex See [Set up Neon in Codex](https://neon.com/docs/ai/agent-setup/codex). ### Cursor See [Set up Neon in Cursor](https://neon.com/docs/ai/agent-setup/cursor). ### VS Code (with GitHub Copilot) See [Set up Neon in VS Code and GitHub Copilot](https://neon.com/docs/ai/agent-setup/vscode). ## Antigravity Antigravity can install Neon's [agent-skills repository](https://github.com/neondatabase/agent-skills) as a plugin, which includes the skills and the Neon MCP Server: ```bash agy plugin install https://github.com/neondatabase/agent-skills ``` Confirm that Antigravity found the plugin, its skills, and the MCP Server with `agy plugin list`. To authenticate, run `/mcp` in Antigravity, select the Neon MCP Server, and complete the OAuth flow. To install with the Neon CLI instead, use `--agent antigravity` with the commands in [Install for any supported agent](https://neon.com/docs/ai/connect-mcp-clients-to-neon#install-for-any-supported-agent). ## Cline (VS Code extension) For skills plus the MCP Server, use the commands in [Install for any supported agent](https://neon.com/docs/ai/connect-mcp-clients-to-neon#install-for-any-supported-agent). To add only the MCP Server: ```bash npx add-mcp https://mcp.neon.tech/mcp -a cline ``` For the Cline CLI, use `-a cline-cli`. To configure the extension by hand: 1. Open Cline in VS Code (sidebar → Cline icon). 2. Click the **MCP Servers** icon → **Installed** → **Configure MCP Servers** to open the configuration file. 3. Add the Neon server entry within the `mcpServers` object. For OAuth, leave out `headers`. For an API key, replace `` with your [Neon API key](https://neon.com/docs/manage/api-keys): ```json { "mcpServers": { "neon": { "type": "streamableHttp", "url": "https://mcp.neon.tech/mcp", "headers": { "Authorization": "Bearer " } } } } ``` 4. Save the file. Cline should reload the configuration automatically. With OAuth, review the requested permissions and click **Authorize** when the browser window opens. For more, see [Get started with Cline and Neon MCP Server](https://neon.com/guides/cline-mcp-neon). ## Devin Desktop (formerly Windsurf) Install Neon from the Devin marketplace: 1. In Devin Desktop, open **Customize**, then **Marketplace**. 2. Find **Neon** and install it. 3. Click **Connect MCP** and sign in to Neon in the browser. The plugin's status changes to **Enabled**. 4. Start a new session so Devin loads the plugin. The marketplace plugin includes the Neon MCP Server and Neon agent skills. ## fx [fx](https://fx.sh) reads MCP servers only from `~/.fx/mcp.json`. A project file can't add a server. add-mcp always writes that global file; `-g` isn't required. **Note:** fx rejects a literal `Authorization` header. Don't pass `--header "Authorization: Bearer $NEON_API_KEY"` when installing to fx. Use `bearer_token_env` (API key tab) or `/mcp auth` (OAuth tab). **OAuth** ```bash npx add-mcp https://mcp.neon.tech/mcp -a fx ``` This writes `~/.fx/mcp.json`: ```json { "mcp": { "neon": { "type": "http", "url": "https://mcp.neon.tech/mcp", "enabled": true } } } ``` A running session applies the change with `/mcp reload`. Then authorize from the fx shell: ```text /mcp auth neon --open ``` Confirm with `/mcp list`. **API key** 1. Create a [Neon API key](https://neon.com/docs/manage/api-keys#creating-api-keys) and export it in the environment fx will inherit: ```bash export NEON_API_KEY= ``` 2. Write `~/.fx/mcp.json`: ```json { "mcp": { "neon": { "type": "http", "url": "https://mcp.neon.tech/mcp", "enabled": true, "bearer_token_env": "NEON_API_KEY" } } } ``` 3. Start a new `fx` or `fx ask` session from this shell. Confirm with `/mcp list`. `/mcp reload` applies a later file change only in a session that already has `NEON_API_KEY`. See [fx MCP](https://fx.sh/docs/capabilities/mcp) for `/mcp reload`, `/mcp auth`, `/mcp list`, and `bearer_token_env`. ## Gamut 1. In your [Gamut](https://www.gamut.so/mcp/developer-tools/neon) agent, go to **Connections** and click **Add Connection**. 2. Search for **Neon** and click **+** to add it. 3. When the OAuth window opens, sign in to Neon and authorize the connection. 4. Ask your agent to query or manage your database on Neon to verify the connection. ## Grok Build Grok Build supports the Neon plugin at user level: ```bash npx neon@latest plugins --agent grok-build ``` The plugin includes the Neon skills and the Neon MCP Server. To add only the MCP Server, run `npx add-mcp https://mcp.neon.tech/mcp -a grok-build`. For the Grok Bot chat app, see [Set up Neon in Grok Bot](https://neon.com/docs/ai/agent-setup/grok-bot). ## Jules 1. Create a [Neon API key](https://neon.com/docs/manage/api-keys#creating-api-keys) from your Neon Console **Settings**. 2. Go to [jules.google.com](https://jules.google.com) > **Settings** > **MCP** (or use [this direct link](https://jules.google.com/settings/mcp)). 3. Click **Connect** on the Neon server and paste your API key when prompted. 4. Run a task invoking the Neon MCP Server to verify the connection. ## Kimi Code Install Neon's [agent-skills repository](https://github.com/neondatabase/agent-skills) as a plugin. Kimi reads its own manifest (`kimi.plugin.json`), which declares the Neon MCP Server, so one command wires up the skills and the MCP connection. In the Kimi CLI chat, run: ```text /plugins install https://github.com/neondatabase/agent-skills ``` Plugin changes apply to new sessions, so run `/new` afterward. You can also run `npx neon@latest plugins --agent kimi-code`. To add only the MCP Server, run `npx add-mcp https://mcp.neon.tech/mcp -a kimi-code`, start a new session, and click **Authorize** when the OAuth window opens. ## Kiro For skills plus the MCP Server, use the commands in [Install for any supported agent](https://neon.com/docs/ai/connect-mcp-clients-to-neon#install-for-any-supported-agent). To add only the MCP Server: ```bash npx add-mcp https://mcp.neon.tech/mcp -a kiro-cli ``` Restart Kiro (or enable the MCP Server in settings). When the OAuth window opens, click **Authorize** to complete the connection. For manual configuration, Kiro reads `~/.kiro/settings/mcp.json` (global) or `.kiro/settings/mcp.json` (project). See [Kiro MCP documentation](https://kiro.dev/docs/mcp/). **Tip: One-click install for Kiro** [https://kiro.dev/launch/mcp/add?name=Neon&config=%7B%22url%22%3A%20%22https%3A//mcp.neon.tech/mcp%22%7D](https://kiro.dev/launch/mcp/add?name=Neon\&config=%7B%22url%22%3A%20%22https%3A//mcp.neon.tech/mcp%22%7D) ## Pi Install Neon's skills in [Pi](https://pi.dev) from npm: ```bash pi install npm:@neon/skills ``` Or straight from the repository: ```bash pi install git:github.com/neondatabase/agent-skills ``` Pi reads the `skills/` directory directly, so there's no separate sync step. This installs the skills only. To add the Neon MCP Server, run `npx neon@latest mcp --agent pi`. ## Zed Zed calls MCP servers **context servers**. For skills plus the MCP Server, use the commands in [Install for any supported agent](https://neon.com/docs/ai/connect-mcp-clients-to-neon#install-for-any-supported-agent). To add only the MCP Server: **OAuth** ```bash npx add-mcp https://mcp.neon.tech/mcp -a zed ``` Restart Zed (or enable the MCP Server in settings). When the OAuth window opens, click **Authorize** to complete the connection. **API key** Add this to `~/.config/zed/settings.json`. Replace `` with your [Neon API key](https://neon.com/docs/manage/api-keys): ```json "context_servers": { "Neon": { "source": "custom", "type": "http", "url": "https://mcp.neon.tech/mcp", "headers": { "Authorization": "Bearer " } } } ``` For more details, including workflow examples and troubleshooting, see [Get started with Zed and the Neon MCP Server](https://neon.com/guides/zed-mcp-neon). ## Other MCP clients For Gemini CLI, Goose, OpenCode, and the other agents in the [table above](https://neon.com/docs/ai/connect-mcp-clients-to-neon#supported-agents-add-mcp), use [Install for any supported agent](https://neon.com/docs/ai/connect-mcp-clients-to-neon#install-for-any-supported-agent). For a client that add-mcp doesn't support, build its config with the [config generator](https://neon.com/docs/ai/neon-mcp-server#config-generator) or write it by hand. Most clients accept `"type": "http"` with the URL `https://mcp.neon.tech/mcp`. If your client only supports local (stdio) servers, use the [`mcp-remote` bridge](https://neon.com/docs/ai/neon-mcp-server#deprecated-stdio). ## Troubleshooting See [MCP troubleshooting](https://neon.com/docs/ai/neon-mcp-server#troubleshooting) for retired SSE endpoints, stdio-only clients, and OAuth `invalid redirect uri` errors. --- ## Related docs (Set up your AI agent) - [Overview](https://neon.com/docs/ai/agent-setup) - [Claude Code](https://neon.com/docs/ai/agent-setup/claude-code) - [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) --- 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/connect-mcp-clients-to-neon"}` to https://feedback.neon.tech/ (no auth required).