How to add InfluxDB v2 MCP Server to Windsurf

Query, write, and manage an InfluxDB v2 instance via the InfluxDB OSS API v2. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

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

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 Windsurf

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

Where is the Windsurf config file?

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

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