Log inSubmit server
Influxdb MCP Server logo

Influxdb MCP Server

by idoru

Connects MCP clients to InfluxDB OSS API v2 for Flux queries, time-series writes, and organization or bucket management.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Influxdb MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "idoru-influxdb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "influxdb-mcp-server"
      ],
      "env": {
        "INFLUXDB_TOKEN": "YOUR_VALUE_HERE",
        "INFLUXDB_URL": "YOUR_VALUE_HERE",
        "INFLUXDB_ORG": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y influxdb-mcp-server

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 24d ago.

Overview

idoru/influxdb-mcp-server MCP server connects MCP clients to an InfluxDB v2 instance through the InfluxDB OSS API v2. It exposes resources for organizations, buckets, measurements, and query results, plus tools for writing data, running Flux queries, and creating database objects. Prompt templates provide Flux query examples and line protocol guidance. Use it when an agent needs to inspect or modify InfluxDB time-series data over stdio or Streamable HTTP.

Use cases

  • Query Flux data from an MCP client
  • Write line protocol time-series records
  • List InfluxDB organizations and buckets
  • Create buckets with retention settings
  • Generate Flux and line protocol guidance

Key features

  • InfluxDB OSS API v2 access
  • Flux query execution
  • Line protocol data writes
  • Organization and bucket creation
  • Organization, bucket, and measurement resources
  • Stdio and Streamable HTTP transports

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

18/18 checks healthy over the last 80d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · influxdb-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars46Stargazers on the source repository.
npm downloads3.7kPackage downloads in the last 30 days.
Last commit9mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Influxdb MCP Server works

What idoru/influxdb-mcp-server MCP server does

The idoru/influxdb-mcp-server MCP server gives an MCP client access to an InfluxDB v2 instance through the InfluxDB OSS API v2. It supports both read and write workflows: an agent can inspect organizations, buckets, and bucket measurements, execute Flux queries, write time-series records, and create organizations or buckets.

The server belongs in the Databases category and is suited to applications where an agent needs operational access to InfluxDB rather than a separate application-specific data layer. Its write operation accepts line protocol data, while query operations use Flux.

How it works

The idoru/influxdb-mcp-server MCP server exposes four resource patterns. influxdb://orgs lists organizations, influxdb://buckets returns bucket metadata, and influxdb://bucket/{bucketName}/measurements lists measurements for a selected bucket. influxdb://query/{orgName}/{fluxQuery} runs a Flux query and makes the returned data available as a resource.

Its tools cover four actions: write-data sends line protocol data to a bucket, query-data executes a Flux query, create-bucket creates a bucket, and create-org creates an organization. The server also provides flux-query-examples and line-protocol-guide prompt templates for common query and ingestion tasks.

Communication uses stdio by default. Starting the process with --http enables Streamable HTTP through the built-in Express server, with port 3000 as the default or a supplied port value.

Setup and configuration

An InfluxDB authentication token is required in INFLUXDB_TOKEN. INFLUXDB_URL can point to a different InfluxDB endpoint; if omitted, the server uses http://localhost:8086. INFLUXDB_ORG optionally supplies a default organization for operations that use one.

The package can run directly with npx influxdb-mcp-server, after a global npm installation, or from a cloned source checkout using npm install followed by npm start. For a Claude Desktop setup, add the server as an stdio process and pass the token and optional connection settings in the client configuration. The repository also documents installation through Smithery for Claude Desktop.

Tools and capabilities

  • Write time-series data with an organization, bucket, line protocol payload, and optional precision.
  • Run Flux queries with an organization and query string.
  • Create buckets with a name, organization ID, and optional retention period.
  • Create organizations with a name and optional description.
  • Browse organization, bucket, and measurement information through MCP resources.
  • Use built-in prompts for Flux syntax examples and line protocol formatting.

Limitations and notes

The documented interface targets InfluxDB OSS API v2 and uses Flux for queries. The server requires a valid API token, and write or administration operations depend on the permissions attached to that token. Integration tests use a Docker-hosted InfluxDB instance and can be run with npm test.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Influxdb MCP Server

idoru/influxdb-mcp-server is an MCP server that connects AI clients to InfluxDB OSS API v2. Its main tools write time-series data, execute Flux queries, create buckets, and create organizations. It also exposes organization, bucket, measurement, and query resources, plus prompts for Flux and line protocol.

Install it with npx, npm globally, or from source. Run `INFLUXDB_TOKEN=your_token npx influxdb-mcp-server`, install with `npm install -g influxdb-mcp-server`, or clone the repository, install dependencies, and run `npm start`.

Only `INFLUXDB_TOKEN` is required. Set `INFLUXDB_URL` to change the InfluxDB endpoint from the default `http://localhost:8086`, and set `INFLUXDB_ORG` to provide a default organization for applicable operations.

Yes, it can work with Cursor through its standard MCP transports. The server uses stdio by default and also supports Streamable HTTP with `--http`; the README provides a specific configuration example for Claude Desktop, not Cursor.

Start it with the `--http` option. `npm start -- --http` uses port 3000, while `npm start -- --http 8080` uses port 8080. The server uses an internal Express.js server for Streamable HTTP transport.

Related MCP servers

All in Databases All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewInfluxdb MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/idoru-influxdb-mcp-server?style=directory)](https://allmcps.com/mcp/idoru-influxdb-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/idoru-influxdb-mcp-server"><img src="https://allmcps.com/api/badge/idoru-influxdb-mcp-server?style=directory" alt="Influxdb MCP Server on AllMCPs" /></a>