Clients¶

Local clients start neon-mcp themselves over stdio; hosted deployments are reached over Streamable HTTP. The examples use neon-mcp on your PATH (see Install); replace it with an absolute path such as /home/me/neon-mcp/.venv/bin/neon-mcp when the client does not share your shell's PATH. JSON-configured clients do not expand ~ or $HOME, so use absolute paths there⁴.

The token is optional; see NEON API token. Put it in the client's environment settings, never in a shared or committed file.

Claude Code¶

claude mcp add neon -s user -e NEON_TOKEN="$NEON_TOKEN" -- neon-mcp --transport stdio
claude mcp list

-s user makes the server available in every project¹; drop the -e option to run without a token.

Claude Desktop¶

Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/; Windows: %APPDATA%\Claude\) and restart the app:

{
  "mcpServers": {
    "neon": {
      "command": "/absolute/path/to/neon-mcp",
      "args": ["--transport", "stdio"],
      "env": { "NEON_TOKEN": "paste-your-token-here" }
    }
  }
}

Codex CLI¶

codex mcp add neon --env NEON_TOKEN="$NEON_TOKEN" -- neon-mcp --transport stdio
codex mcp list

This writes the server into ~/.codex/config.toml²; restart running sessions.

OpenCode¶

Add to ~/.config/opencode/opencode.json³:

{
  "mcp": {
    "neon": {
      "type": "local",
      "command": ["/absolute/path/to/neon-mcp", "--transport", "stdio"],
      "enabled": true,
      "environment": { "NEON_TOKEN": "paste-your-token-here" }
    }
  }
}

Google Antigravity¶

Add to ~/.gemini/config/mcp_config.json (older installs: ~/.gemini/antigravity/mcp_config.json):

{
  "mcpServers": {
    "neon": {
      "command": "/absolute/path/to/neon-mcp",
      "args": ["--transport", "stdio"],
      "env": { "NEON_TOKEN": "paste-your-token-here" }
    }
  }
}

Any other stdio client¶

Run neon-mcp --transport stdio (bare neon-mcp does the same) with the token in the environment. The server speaks MCP 2026-07-28 and still accepts clients on earlier protocol revisions over stdio.

A hosted server (HTTP)¶

claude mcp add --transport http neon https://neon-mcp.example.org/mcp \
  --header "X-API-Token: $NEON_TOKEN"

Each user sends their own token in X-API-Token; the server honours it only over HTTPS (see Transports). Over HTTP neon_download_files is not offered: use the signed URLs from neon_list_files instead.