An MCP server that provides access to InfluxDB instances through the InfluxDB OSS API v2, enabling time series queries, data writes, and database management.

Installation

Smithery

npx -y @smithery/cli install @idoru/influxdb-mcp-server --client claude

NPX

INFLUXDB_TOKEN=your_token npx influxdb-mcp-server

Global Installation

npm install -g influxdb-mcp-server
INFLUXDB_TOKEN=your_token influxdb-mcp-server

From Source

git clone https://github.com/idoru/influxdb-mcp-server.git
cd influxdb-mcp-server
npm install
INFLUXDB_TOKEN=your_token npm start

Configuration

Claude Desktop (NPX)

{
  "mcpServers": {
    "influxdb": {
      "command": "npx",
      "args": ["influxdb-mcp-server"],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

Claude Desktop (Local)

{
  "mcpServers": {
    "influxdb": {
      "command": "node",
      "args": ["/path/to/influxdb-mcp-server/src/index.js"],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

Available Tools

Tool	Description
write-data	Writes time series data in line protocol format
query-data	Executes Flux queries
create-bucket	Creates a new bucket
create-org	Creates a new organization

Features

• Access organization, bucket, and measurement data through resources
• Write data, execute queries, and manage database objects using tools
• Templates for common Flux queries and Line Protocol format
• Support for stdio and HTTP transport modes
• Comprehensive resource access, including organizations, buckets, and measurements
• Query execution with results returned as resources

Environment Variables

Required

• INFLUXDB_TOKEN - Authentication token for InfluxDB API

Optional

• INFLUXDB_URL - URL of the InfluxDB instance
• INFLUXDB_ORG - Default organization name for certain operations

Notes

The server supports stdio (default) and HTTP transport modes. It can be run with the --http flag for Express.js server mode on port 3000 or a custom port. Includes comprehensive integration tests with Docker container setup and sample data.