# InfluxDB 3

The official InfluxDB 3 MCP server lets an agent read and write data, inspect schemas and trace query errors. Handy when you want to dig into a database from chat.

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

## What it does

The server hands your agent tools for InfluxDB 3 Core, Enterprise, Cloud Dedicated, Clustered and Cloud Serverless. It can run SQL and InfluxQL, write points, and manage databases and tokens. Which tools show up depends on the profile: with `INFLUX_MCP_TOOL_PROFILE=readonly` only read and discovery tools remain, and anything that mutates data or administers the instance is left out.

The token travels in a `Bearer` header and the server never inspects it, so the token's own permissions decide what is reachable. A scoped token simply won't see the rest. Failures come back structured, with `error.code`, `error.recovery` and `error.retryable`. A `403` maps to `not_found_or_denied`, and a query against a table that doesn't exist tells you to fix the reference via `list_tables` or `describe_table`.

You need Node.js v20.11 or newer plus the URL and token of an InfluxDB 3 instance. The Docker path needs Docker. Local development runs on pnpm, pinned in `package.json` and activated with `corepack enable`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `INFLUX_DB_PRODUCT_TYPE`, `INFLUX_DB_TOKEN`, `INFLUX_DB_INSTANCE_URL`, `INFLUX_DB_MANAGEMENT_TOKEN`, `INFLUX_DB_ACCOUNT_ID`, `INFLUX_DB_CLUSTER_ID`, `INFLUX_MCP_TOOL_PROFILE` — 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 INFLUX_DB_PRODUCT_TYPE=<INFLUX_DB_PRODUCT_TYPE> --env INFLUX_DB_TOKEN=<INFLUX_DB_TOKEN> --env INFLUX_DB_INSTANCE_URL=<INFLUX_DB_INSTANCE_URL> --env INFLUX_DB_MANAGEMENT_TOKEN=<INFLUX_DB_MANAGEMENT_TOKEN> --env INFLUX_DB_ACCOUNT_ID=<INFLUX_DB_ACCOUNT_ID> --transport stdio influxdb-3 -- npx -y @influxdata/influxdb3-mcp-server
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add influxdb-3 --env INFLUX_DB_PRODUCT_TYPE=<INFLUX_DB_PRODUCT_TYPE> --env INFLUX_DB_TOKEN=<INFLUX_DB_TOKEN> --env INFLUX_DB_INSTANCE_URL=<INFLUX_DB_INSTANCE_URL> --env INFLUX_DB_MANAGEMENT_TOKEN=<INFLUX_DB_MANAGEMENT_TOKEN> --env INFLUX_DB_ACCOUNT_ID=<INFLUX_DB_ACCOUNT_ID> -- npx -y @influxdata/influxdb3-mcp-server
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "influxdb-3": {
            "command": "npx",
            "args": [
                "-y",
                "@influxdata/influxdb3-mcp-server"
            ],
            "env": {
                "INFLUX_DB_PRODUCT_TYPE": "<INFLUX_DB_PRODUCT_TYPE>",
                "INFLUX_DB_TOKEN": "<INFLUX_DB_TOKEN>",
                "INFLUX_DB_INSTANCE_URL": "<INFLUX_DB_INSTANCE_URL>",
                "INFLUX_DB_MANAGEMENT_TOKEN": "<INFLUX_DB_MANAGEMENT_TOKEN>",
                "INFLUX_DB_ACCOUNT_ID": "<INFLUX_DB_ACCOUNT_ID>"
            }
        }
    }
}
```
Replace <…> with your own values. 2 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "influxdb-3": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@influxdata/influxdb3-mcp-server"
            ],
            "env": {
                "INFLUX_DB_PRODUCT_TYPE": "<INFLUX_DB_PRODUCT_TYPE>",
                "INFLUX_DB_TOKEN": "<INFLUX_DB_TOKEN>",
                "INFLUX_DB_INSTANCE_URL": "<INFLUX_DB_INSTANCE_URL>",
                "INFLUX_DB_MANAGEMENT_TOKEN": "<INFLUX_DB_MANAGEMENT_TOKEN>",
                "INFLUX_DB_ACCOUNT_ID": "<INFLUX_DB_ACCOUNT_ID>"
            }
        }
    }
}
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e INFLUX_DB_PRODUCT_TYPE=<INFLUX_DB_PRODUCT_TYPE> -e INFLUX_DB_TOKEN=<INFLUX_DB_TOKEN> -e INFLUX_DB_INSTANCE_URL=<INFLUX_DB_INSTANCE_URL> -e INFLUX_DB_MANAGEMENT_TOKEN=<INFLUX_DB_MANAGEMENT_TOKEN> -e INFLUX_DB_ACCOUNT_ID=<INFLUX_DB_ACCOUNT_ID> influxdb-3 npx -y @influxdata/influxdb3-mcp-server
```
Replace <…> with your own values. 2 more environment variables are in the server README

## When to use it
- run SQL or InfluxQL against a database from inside the agent
- list databases, tables and columns before writing a query
- figure out why a dashboard panel went blank after a deploy
- tell missing data apart from a broken query
- give an agent read access with no write or admin tools

## Example prompts
- List the databases and tables in InfluxDB, then average the sensor temperature over the last day
- Why does this InfluxQL query return nothing? Check the measurement and its columns
- Build a bounded SQL query against `sensors` and return the rows with any warnings

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27669
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49845

---
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