MCP Directory

How to add InfluxDB MCP Server to Cursor

Official MCP server for InfluxDB 3 (Core/Enterprise/Cloud) — query, write, and manage databases and tokens. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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

  1. 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the InfluxDB MCP Server config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of InfluxDB MCP Server's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the InfluxDB MCP Server config there under the "mcpServers" key and restart the client.

Is InfluxDB MCP Server safe to use with Cursor?

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.

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