How to add InfluxDB MCP Server to Claude Desktop

Official MCP server for InfluxDB 3 (Core/Enterprise/Cloud) — query, write, and manage databases and tokens. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

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

Claude Desktop config for InfluxDB MCP Server

npx -y @influxdata/influxdb3-mcp-server

{
  "mcpServers": {
    "influxdb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@influxdata/influxdb3-mcp-server"
      ],
      "env": {
        "INFLUX_DB_INSTANCE_URL": "http://localhost:8181/",
        "INFLUX_DB_TOKEN": "<YOUR_INFLUXDB_TOKEN>",
        "INFLUX_DB_PRODUCT_TYPE": "core"
      }
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the InfluxDB 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 MCP Server's tools appear under the 🔌 tools menu.

Before you start

An InfluxDB 3 instance: URL and token (Core/Enterprise/Cloud Serverless), or Cluster ID and tokens (Cloud Dedicated/Clustered)
Node.js v20.11 or newer (for npm/npx usage)
npm v9 or newer (for npm/npx usage)
Docker (for the Docker-based setup)

What InfluxDB MCP Server can do in Claude Desktop

load_database_context

Load optional custom database context and documentation (all versions).

get_help

Get help and troubleshooting guidance for InfluxDB operations (all versions).

write_line_protocol

Write data using InfluxDB line protocol (all versions).

create_database

Create a new database, with cloud-specific config options (all versions).

update_database

Update database configuration: retention for all; maxTables/maxColumns for Cloud Dedicated/Clustered (all versions).

delete_database

Delete a database by name (irreversible; all versions).

execute_query

Run a SQL query against a database, supporting multiple output formats (all versions).

get_measurements

List all measurements (tables) in a database (all versions).

Security

Requires an InfluxDB token passed via the INFLUX_DB_TOKEN environment variable (and optionally a management token for cloud editions). Several tools are destructive or sensitive: delete_database is irreversible, regenerate_operator_token is dangerous/irreversible, and the create/delete token tools grant or revoke access. Scope tokens to least privilege; for Cloud Dedicated/Clustered you can supply a database-token-only combination to restrict the server to query/write operations.

InfluxDB 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 MCP Server config there under the "mcpServers" key and restart the client.

Is InfluxDB MCP Server safe to use with Claude Desktop?

Which InfluxDB editions are supported?

InfluxDB 3 Core, Enterprise, Cloud Dedicated, Clustered, and Cloud Serverless. Some token-management tools are limited to specific editions (e.g. admin/resource tokens are Core/Enterprise only; cloud database token tools are for Cloud Dedicated/Clustered).

How is it configured?

Entirely through environment variables. At minimum set INFLUX_DB_INSTANCE_URL, INFLUX_DB_TOKEN, and INFLUX_DB_PRODUCT_TYPE. Cloud Dedicated/Clustered editions accept additional variables (cluster ID, account ID, management token) and support query-only, management-only, or full-access token combinations.

What are the installation options?

Run it locally via a Node build, directly with npx using @influxdata/influxdb3-mcp-server, or via Docker (building the image first with docker compose build or npm run docker:build). The README includes ready-to-use example-*.mcp.json templates for each.

View repo Full InfluxDB MCP Server page