influxdb

This MCP server exposes an InfluxDB v2 instance through a set of resources and tools that let you explore metadata and run operations against InfluxDB. You can list organizations and buckets, fetch measurements within a bucket, and execute Flux queries or write time-series data using the provided tools. The prompts include templates to help assemble Flux queries and to guide you in formatting data with the InfluxDB line protocol. Use the API endpoints as resources (e.g., influxdb://orgs, influxdb://buckets, influxdb://bucket/{name}/measurements, influxdb://query/{org}/{flux}) to retrieve or manipulate data, and leverage the tools (write-data, query-data, create-bucket, create-org) to perform common admin and data-ingestion tasks. When integrated with Claude for Desktop, you can connect the MCP server via a configuration entry that specifies the command, arguments, and environment variables, enabling seamless invocation from your workflow. Ensure you supply INFLUXDB_TOKEN and, if needed, set INFLUXDB_URL and INFLUXDB_ORG for proper authentication and scoping of operations.

Prerequisites:

• Node.js and npm installed on your system
• Access token for your InfluxDB v2 instance (INFLUXDB_TOKEN)
• (Optional) InfluxDB URL and default organization (INFLUXDB_URL and INFLUXDB_ORG)

Installation options:

Option A: Install via Smithery (recommended for Claude Desktop integration)

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

Option B: Run with npx (recommended for quick start)

INFLUXDB_TOKEN=your_token npx influxdb-mcp-server

Option C: Install globally

# Install globally
npm install -g influxdb-mcp-server

# Run the server
INFLUXDB_TOKEN=your_token influxdb-mcp-server

Option D: Run from source

# Clone the repository
git clone https://github.com/idoru/influxdb-mcp-server.git
cd influxdb-mcp-server

# Install dependencies
npm install

# Run the server
INFLUXDB_TOKEN=your_token npm start

Transport modes:

• By default, the server uses stdio transport. You can enable the Streamable HTTP transport with the --http option (default port 3000). Example:

# Start with Streamable HTTP transport on default port 3000
INFLUXDB_TOKEN=your_token npm start -- --http

# Start on a specific port
INFLUXDB_TOKEN=your_token npm start -- --http 8080

If you installed globally or are using npx, examples:

INFLUXDB_TOKEN=your_token influxdb-mcp-server --http
# or force stdio
INFLUXDB_TOKEN=your_token influxdb-mcp-server --stdio
# or http on a specific port
INFLUXDB_TOKEN=your_token influxdb-mcp-server --http 8080

Environment variables:

• INFLUXDB_TOKEN: required for authentication with InfluxDB.
• INFLUXDB_URL: optional; defaults to http://localhost:8086 if not provided.
• INFLUXDB_ORG: optional; default organization for certain operations.

Tips:

• When integrating with Claude for Desktop, you can use either npx-based invocation or a local node-based path in the claude_desktop_config.json, as shown in the README.
• The server exposes Flux query templates and line protocol guidelines to help you form valid queries and data payloads quickly.
• If you encounter connection issues, verify that INFLUXDB_TOKEN is correct and that INFLUXDB_URL points to a reachable InfluxDB v2 instance. Check CORS or network restrictions if using the HTTP transport.
• The module supports both stdio and HTTP transports; choose the one that best fits your workflow and environment.