MCP Directory

How to add InfluxDB MCP Server to Windsurf

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

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

Windsurf 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 Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the InfluxDB MCP Server config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5InfluxDB MCP Server's tools become available to Cascade.

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 Windsurf

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

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_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 Windsurf?

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