InfluxDB MCP Server

Name: InfluxDB MCP Server
Author: idoru

@idoru

Repository

About InfluxDB MCP Server

An MCP Server for querying InfluxDB

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "influxdb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@idoru/influxdb-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

org, bucket, data, precision (optional)

org, query

name, orgID, retentionPeriodSeconds (optional)

name, description (optional)

Overview

What is InfluxDB MCP Server?

InfluxDB MCP Server is a Model Context Protocol server that exposes access to an InfluxDB v2 instance through the InfluxDB OSS API v2. It provides resources for browsing organizations, buckets, and measurements, tools for writing data and executing Flux queries, and prompt templates for common database operations.

How to use InfluxDB MCP Server?

Set the INFLUXDB_TOKEN environment variable, optionally configure INFLUXDB_URL (defaults to http://localhost:8086) and INFLUXDB_ORG, then run the server via npx influxdb-mcp-server. The server uses stdio transport by default and can also start with Streamable HTTP transport using the --http flag. Add it to your MCP client configuration, such as claude_desktop_config.json.

Key features of InfluxDB MCP Server

Resources for listing organizations, buckets, and measurements
Tools to write time-series data and execute Flux queries
Tools to create new buckets and organizations
Prompt templates for common Flux queries and Line Protocol format
Configurable HTTP or stdio transport modes
Modular code structure with separation of concerns

Use cases of InfluxDB MCP Server

Querying time-series metrics from an InfluxDB instance through an AI assistant
Writing sensor or IoT data in Line Protocol format programmatically
Managing InfluxDB organizations and buckets via natural language commands
Exploring database schema and measurement structures interactively

FAQ from InfluxDB MCP Server

What environment variables are required to run the server?

INFLUXDB_TOKEN is required. INFLUXDB_URL (default http://localhost:8086) and INFLUXDB_ORG are optional.

How do I install or run InfluxDB MCP Server?

Run directly with npx (INFLUXDB_TOKEN=your_token npx influxdb-mcp-server), install globally via npm, or clone and run from source. Smithery installation for Claude Desktop is also supported.

What transport options does the server support?

The server supports stdio transport (default) and Streamable HTTP transport via the --http flag, optionally specifying a port (defaults to 3000).

How do I integrate InfluxDB MCP Server with Claude Desktop?

Add an entry to claude_desktop_config.json under mcpServers using npx or a local path, with the required environment variables.

What can I access and manage with this server?

List organizations and buckets, view measurements within a bucket, execute Flux queries, write data in Line Protocol format, and create new buckets or organizations.