---
title: Neon
description: Manage Neon projects, run queries, and make schema changes.
type: connection
keywords:
  - mcp
  - postgres
  - databases
  - branches
  - sql
  - oauth
  - connect
---

# Neon

Connection integration for eve. Manage Neon projects, run queries, and make schema changes.

## Install

Add the connection from eve's registry. This writes the initial definition under `agent/connections/` and installs its authentication dependency when needed:

```bash
eve add connection/neon
```

## Quick start

### MCP · App

Create `agent/connections/neon.ts`. The connection name is derived from the filename:

```ts
// agent/connections/neon.ts
import { connect } from "@vercel/connect/eve";
import { defineMcpClientConnection } from "eve/connections";

export default defineMcpClientConnection({
  url: "https://mcp.neon.tech/mcp",
  description: "Neon: manage projects, run queries, and make schema changes.",
  auth: connect({ connector: "neon/neon", principalType: "app" }),
});
```

Connect authenticates as the agent itself through one shared installation, with no per-user consent.

## Configure

### MCP · App

Link your project, create the connector, and pull OIDC locally:

```bash
vercel link
vercel connect create neon
vercel env pull
```

Neon's MCP server can modify projects and databases. Use a development or test project, review tool calls, and append `?readonly=true` or `?projectId=<project-id>` to scope access.

See the [Connections docs](/docs/connections) for principal types, headers, approval, and protocol-specific filters.

[Read the full connection documentation](https://neon.com/docs/ai/neon-mcp-server)

---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)