MCP Directory

InfluxDB v2 MCP Server

Query, write, and manage an InfluxDB v2 instance via the InfluxDB OSS API v2.

Unverified
stdio (local)
API key
JavaScript
View repo 41 npm

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run
npx influxdb-mcp-server

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "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"
      }
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

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)

About InfluxDB v2 MCP Server

InfluxDB v2 MCP Server connects MCP clients (such as Claude Desktop) to an InfluxDB v2 instance through the InfluxDB OSS API v2. It exposes read-only resources for discovering organizations, buckets, and measurements, plus tools for writing time-series data, executing Flux queries, and creating buckets and organizations. Two prompt templates help craft Flux queries and Line Protocol payloads. The server defaults to stdio transport and optionally supports Streamable HTTP.

Tools & capabilities (4)

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).

When to use it

  • Query time-series data from InfluxDB using Flux directly from an AI assistant
  • Write metrics or sensor data in line protocol format into a bucket
  • Browse organizations, buckets, and measurements to explore a dataset
  • Provision new buckets and organizations during setup or experimentation

Security notes

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 FAQ

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.

Can I install it for Claude Desktop automatically?

Yes. It can be installed via Smithery with: npx -y @smithery/cli install @idoru/influxdb-mcp-server --client claude.

#influxdb#time-series#database#flux#metrics#line-protocol

Alternatives to InfluxDB v2 MCP Server

Compare all alternatives →
MCP Toolbox for Databases (BigQuery)
Databases
16k

Google's official MCP server with prebuilt BigQuery tools, querying datasets via Application Default Credentials.

Verified
stdio (local)
OAuth
Go
10 tools
Updated 23 days agoRepo
InstantDB MCP
Databases
10k

Create, manage, and query your InstantDB apps, schemas, permissions, and data from your AI editor.

Unverified
HTTP (remote)
OAuth
TypeScript
7 tools
Updated 1 day agoRepo
DBHub
Databases
3.0k

Zero-dependency, token-efficient database MCP server for Postgres, MySQL, SQL Server, MariaDB, and SQLite.

Unverified
stdio (local)
No auth
TypeScript
3 tools
Updated 1 day agoRepo

Compare InfluxDB v2 MCP Server with:

vs MCP Toolbox for Databases (BigQuery)vs InstantDB MCPvs DBHubvs Postgres MCP Pro