MCP Directory

InfluxDB MCP Server

Official MCP server for InfluxDB 3 (Core/Enterprise/Cloud) — query, write, and manage databases and tokens.

Unverified
stdio (local)
API key
TypeScript
View repo 33 npm

Add to your client

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

Install / run
npx -y @influxdata/influxdb3-mcp-server

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

{
  "mcpServers": {
    "influxdb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@influxdata/influxdb3-mcp-server"
      ],
      "env": {
        "INFLUX_DB_INSTANCE_URL": "http://localhost:8181/",
        "INFLUX_DB_TOKEN": "<YOUR_INFLUXDB_TOKEN>",
        "INFLUX_DB_PRODUCT_TYPE": "core"
      }
    }
  }
}

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

Before you start

  • An InfluxDB 3 instance: URL and token (Core/Enterprise/Cloud Serverless), or Cluster ID and tokens (Cloud Dedicated/Clustered)
  • Node.js v20.11 or newer (for npm/npx usage)
  • npm v9 or newer (for npm/npx usage)
  • Docker (for the Docker-based setup)

About InfluxDB MCP Server

InfluxData's official MCP server for InfluxDB 3. It connects MCP clients to any InfluxDB v3 edition (Core, Enterprise, Cloud Dedicated, Clustered, Cloud Serverless) and provides tools for querying with SQL, writing line protocol, exploring schemas, managing databases and retention, and administering tokens. Resources expose configuration, health, and database listings, while prompts offer ready-made operations. Runs over stdio via Node/npx or Docker, configured through environment variables.

Tools & capabilities (22)

load_database_context

Load optional custom database context and documentation (all versions).

get_help

Get help and troubleshooting guidance for InfluxDB operations (all versions).

write_line_protocol

Write data using InfluxDB line protocol (all versions).

create_database

Create a new database, with cloud-specific config options (all versions).

update_database

Update database configuration: retention for all; maxTables/maxColumns for Cloud Dedicated/Clustered (all versions).

delete_database

Delete a database by name (irreversible; all versions).

execute_query

Run a SQL query against a database, supporting multiple output formats (all versions).

get_measurements

List all measurements (tables) in a database (all versions).

get_measurement_schema

Get the schema (columns/types) for a measurement/table (all versions).

create_admin_token

Create a new admin token with full permissions (Core/Enterprise only).

list_admin_tokens

List all admin tokens, with optional filtering (Core/Enterprise only).

create_resource_token

Create a resource token for specific databases and permissions (Core/Enterprise only).

list_resource_tokens

List all resource tokens, with filtering and ordering (Core/Enterprise only).

delete_token

Delete a token by name (Core/Enterprise only).

regenerate_operator_token

Regenerate the operator token (dangerous/irreversible; Core/Enterprise only).

cloud_list_database_tokens

List all database tokens for a Cloud Dedicated/Clustered cluster.

cloud_get_database_token

Get details of a specific database token by ID (Cloud Dedicated/Clustered).

cloud_create_database_token

Create a new database token for a Cloud Dedicated/Clustered cluster.

cloud_update_database_token

Update an existing database token (Cloud Dedicated/Clustered).

cloud_delete_database_token

Delete a database token from a Cloud Dedicated/Clustered cluster.

list_databases

List all available databases in the instance (all versions).

health_check

Check InfluxDB connection and health status (all versions).

What this server can do

InfluxDB MCP Server provides tools for these capabilities — tap one to see every MCP server that does the same:

Execute SQLInspect database schema

When to use it

  • Ask an AI assistant to run SQL queries against InfluxDB 3 time-series data and return formatted results.
  • Write metrics or events into InfluxDB using line protocol from within a chat workflow.
  • Explore database structure by listing measurements and inspecting column schemas.
  • Create, update (retention/limits), or delete databases across InfluxDB editions.
  • Administer access by creating, listing, and deleting admin, resource, or cloud database tokens.
  • Check instance health and configuration via built-in resources and prompts.

Security notes

Requires an InfluxDB token passed via the INFLUX_DB_TOKEN environment variable (and optionally a management token for cloud editions). Several tools are destructive or sensitive: delete_database is irreversible, regenerate_operator_token is dangerous/irreversible, and the create/delete token tools grant or revoke access. Scope tokens to least privilege; for Cloud Dedicated/Clustered you can supply a database-token-only combination to restrict the server to query/write operations.

InfluxDB MCP Server FAQ

Which InfluxDB editions are supported?

InfluxDB 3 Core, Enterprise, Cloud Dedicated, Clustered, and Cloud Serverless. Some token-management tools are limited to specific editions (e.g. admin/resource tokens are Core/Enterprise only; cloud database token tools are for Cloud Dedicated/Clustered).

How is it configured?

Entirely through environment variables. At minimum set INFLUX_DB_INSTANCE_URL, INFLUX_DB_TOKEN, and INFLUX_DB_PRODUCT_TYPE. Cloud Dedicated/Clustered editions accept additional variables (cluster ID, account ID, management token) and support query-only, management-only, or full-access token combinations.

What are the installation options?

Run it locally via a Node build, directly with npx using @influxdata/influxdb3-mcp-server, or via Docker (building the image first with docker compose build or npm run docker:build). The README includes ready-to-use example-*.mcp.json templates for each.

Is it official?

Yes. It is maintained by InfluxData, the company behind InfluxDB, and is licensed under MIT.

#influxdb#time-series#database#sql#line-protocol#monitoring

Alternatives to InfluxDB 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 MCP Server with:

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