How to add InfluxDB v2 MCP Server to Claude Desktop

Query, write, and manage an InfluxDB v2 instance via the InfluxDB OSS API v2. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 41★ · stdio · apikey

Claude Desktop config for InfluxDB v2 MCP Server

npx influxdb-mcp-server

{
  "mcpServers": {
    "influxdb-v2-mcp-server": {
      "command": "npx",
      "args": [
        "influxdb-mcp-server"
      ],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the InfluxDB v2 MCP Server config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm InfluxDB v2 MCP Server's tools appear under the 🔌 tools menu.

Before you start

An InfluxDB v2 (OSS API v2) instance, reachable at INFLUXDB_URL (defaults to http://localhost:8086)
An InfluxDB API authentication token set via INFLUXDB_TOKEN
Node.js with npx (for the recommended npx-based run/install)

What InfluxDB v2 MCP Server can do in Claude Desktop

write-data

Write time-series data in line protocol format. Parameters: org, bucket, data, precision (optional).

query-data

Execute Flux queries. Parameters: org, query.

create-bucket

Create a new bucket. Parameters: name, orgID, retentionPeriodSeconds (optional).

create-org

Create a new organization. Parameters: name, description (optional).

Security

Requires an InfluxDB API authentication token supplied via the INFLUXDB_TOKEN environment variable. The token grants the configured access to your InfluxDB instance (read/write/manage), so scope it appropriately and keep it secret.

InfluxDB v2 MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the InfluxDB v2 MCP Server config there under the "mcpServers" key and restart the client.

Is InfluxDB v2 MCP Server safe to use with Claude Desktop?

Which InfluxDB version does this support?

InfluxDB v2, accessed through the InfluxDB OSS API v2.

What transports are available?

stdio by default (selectable with --stdio), or Streamable HTTP with the --http option and an optional port (defaults to 3000), served via an internal Express.js server.

What environment variables are required?

INFLUXDB_TOKEN is required. INFLUXDB_URL (defaults to http://localhost:8086) and INFLUXDB_ORG (default org for certain operations) are optional.

View repo Full InfluxDB v2 MCP Server page