# growthbook-mcp

Connects an agent to GrowthBook for skill lookup and authenticated API operations. Useful when feature-flag workflows need to run from a coding client.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 24
- Author: growthbook
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/growthbook/growthbook-mcp
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/mcp/growthbook-mcp

## What it does

growthbook-mcp exposes four tools: one lists available skills, another reads a skill or a nested workflow, and two pass requests to the GrowthBook API. Read and write operations use separate tools. The skill files are bundled from `growthbook/skills` during the build, while API calls stay inside the MCP server rather than invoking `gb-call`.

Stdio access requires `GB_API_KEY`, and `GB_API_URL` sets the API base address. You can run the published `@growthbook/mcp` package or build the server locally with `npm install` followed by `npm run build`. HTTP mode also requires `GB_MCP_URL` plus transport settings. Without `GB_API_KEY`, a stdio setup cannot authenticate with GrowthBook.

Set `GB_SKILLS_ENABLED=false` to register API tools only. Remote HTTP clients can use `/mcp/api`, which exposes the read and write API tools without the skill tools.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `GB_API_KEY`, `GB_API_URL`, `GB_SKILLS_ENABLED` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env GB_API_KEY=<GB_API_KEY> --env GB_API_URL=<GB_API_URL> --env GB_SKILLS_ENABLED=<GB_SKILLS_ENABLED> --transport stdio growthbook-mcp -- npx -y @growthbook/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add growthbook-mcp --env GB_API_KEY=<GB_API_KEY> --env GB_API_URL=<GB_API_URL> --env GB_SKILLS_ENABLED=<GB_SKILLS_ENABLED> -- npx -y @growthbook/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "growthbook-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@growthbook/mcp"
            ],
            "env": {
                "GB_API_KEY": "<GB_API_KEY>",
                "GB_API_URL": "<GB_API_URL>",
                "GB_SKILLS_ENABLED": "<GB_SKILLS_ENABLED>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "growthbook-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@growthbook/mcp"
            ],
            "env": {
                "GB_API_KEY": "<GB_API_KEY>",
                "GB_API_URL": "<GB_API_URL>",
                "GB_SKILLS_ENABLED": "<GB_SKILLS_ENABLED>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e GB_API_KEY=<GB_API_KEY> -e GB_API_URL=<GB_API_URL> -e GB_SKILLS_ENABLED=<GB_SKILLS_ENABLED> growthbook-mcp npx -y @growthbook/mcp
```
Replace <…> with your own values

## When to use it
- look up GrowthBook workflows
- read data through the GrowthBook API
- send changes to GrowthBook objects
- keep API reads separate from writes
- run the server without skill tools

## Example prompts
- Read the `feature-flags` skill and tell me which workflow fits a new flag.
- Fetch the GrowthBook project list through the API and summarize the response.
- Create a feature flag from `payload.json` using the GrowthBook write API tool.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md