InfluxDB 3

v1.0.0โ€ขDatabasesโ€ขstable

๐ŸŽ–๏ธ ๐Ÿ“‡ ๐Ÿ  โ˜๏ธ - Official MCP server for InfluxDB 3 Core/Enterprise/Cloud Dedicated

influxdb3mcpai-integration
Share:
31
Stars
0
Downloads
0
Weekly
0/5

What is InfluxDB 3?

InfluxDB 3 is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐ŸŽ–๏ธ ๐Ÿ“‡ ๐Ÿ  โ˜๏ธ - official mcp server for influxdb 3 core/enterprise/cloud dedicated

๐ŸŽ–๏ธ ๐Ÿ“‡ ๐Ÿ  โ˜๏ธ - Official MCP server for InfluxDB 3 Core/Enterprise/Cloud Dedicated

This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • ๐ŸŽ–๏ธ ๐Ÿ“‡ ๐Ÿ  โ˜๏ธ - Official MCP server for InfluxDB 3 Core/Enterpri

Use Cases

Query InfluxDB 3 Core, Enterprise, or Cloud Dedicated instances via AI interface.
Analyze time-series data using official MCP server integration.
Access official InfluxDB 3 capabilities through Model Context Protocol.
influxdata

Maintainer

LicenseNOASSERTION
Languagetypescript
Versionv1.0.0
UpdatedMay 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx influxdb3

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use InfluxDB 3

The official InfluxDB 3 MCP Server from InfluxData connects AI assistants directly to InfluxDB 3 Core, Enterprise, Cloud Serverless, and Cloud Dedicated instances, enabling natural language queries and management of time-series data. It exposes tools for executing SQL queries, writing line protocol data, managing databases and tokens, inspecting measurement schemas, and performing health checks. This server is the recommended bridge for using AI models to analyze and operate on IoT sensor data, metrics, and other time-series workloads stored in InfluxDB 3.

Prerequisites

  • Node.js v20.11 or higher and npm v9 or higher (for local/npx setup)
  • A running InfluxDB 3 instance (Core, Enterprise, Cloud Serverless, or Cloud Dedicated)
  • An InfluxDB authentication token with appropriate permissions for your target databases
  • Docker and docker-compose (optional, for containerized deployment)
  • An MCP client such as Claude Desktop
1

Identify your InfluxDB 3 deployment type

The required environment variables differ by deployment type. Determine whether you are running Core/Enterprise, Cloud Serverless, or Cloud Dedicated/Clustered before configuring.

2

Gather your connection credentials

For Core/Enterprise and Cloud Serverless, you need the instance URL and an authentication token. For Cloud Dedicated, you need a Cluster ID and token. For Cloud Clustered, use the instance URL and token.

# Core or Enterprise:
export INFLUX_DB_INSTANCE_URL="http://localhost:8086"
export INFLUX_DB_TOKEN="your_token_here"
export INFLUX_DB_PRODUCT_TYPE="core"  # or "enterprise"

# Cloud Serverless:
export INFLUX_DB_INSTANCE_URL="https://us-east-1-1.aws.cloud2.influxdata.com"
export INFLUX_DB_TOKEN="your_token_here"
export INFLUX_DB_PRODUCT_TYPE="cloud-serverless"

# Cloud Dedicated:
export INFLUX_DB_CLUSTER_ID="your_cluster_id"
export INFLUX_DB_TOKEN="your_database_token"
export INFLUX_DB_MANAGEMENT_TOKEN="your_management_token"
3

Run the server with npx

The quickest way to start is via npx, which downloads and runs the server without a global install.

npx @influxdata/influxdb3-mcp-server
4

Configure Claude Desktop

Add the server to your Claude Desktop configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) with your environment variables.

{
  "mcpServers": {
    "influxdb3": {
      "command": "npx",
      "args": ["-y", "@influxdata/influxdb3-mcp-server"],
      "env": {
        "INFLUX_DB_INSTANCE_URL": "http://localhost:8086",
        "INFLUX_DB_TOKEN": "your_token_here",
        "INFLUX_DB_PRODUCT_TYPE": "core"
      }
    }
  }
}
5

Restart Claude Desktop and verify connection

Restart Claude Desktop to load the new MCP server. You can verify the connection by asking Claude to check the health of your InfluxDB instance.

InfluxDB 3 Examples

Client configuration

Claude Desktop configuration for a local InfluxDB 3 Core instance. Adjust the product type and URL for your deployment.

{
  "mcpServers": {
    "influxdb3": {
      "command": "npx",
      "args": ["-y", "@influxdata/influxdb3-mcp-server"],
      "env": {
        "INFLUX_DB_INSTANCE_URL": "http://localhost:8086",
        "INFLUX_DB_TOKEN": "your_influxdb_token",
        "INFLUX_DB_PRODUCT_TYPE": "core"
      }
    }
  }
}

Prompts to try

Example prompts for querying and managing your InfluxDB 3 instance.

- "Show me all databases in my InfluxDB instance"
- "Query the last 24 hours of CPU metrics from the 'system_metrics' measurement"
- "What measurements exist in the 'sensors' database?"
- "Create a new database called 'iot_data' with a 90-day retention period"
- "Write a data point: temperature,location=office value=22.5"
- "Run a health check on my InfluxDB instance"

Troubleshooting InfluxDB 3

Authentication errors when connecting to InfluxDB

Verify that INFLUX_DB_TOKEN is a valid token with the correct permissions. For Cloud Dedicated, you may need separate INFLUX_DB_TOKEN (for database operations) and INFLUX_DB_MANAGEMENT_TOKEN (for admin tasks like creating tokens).

Server starts but cannot reach the InfluxDB instance

Confirm INFLUX_DB_INSTANCE_URL is correct and accessible from your machine. For local instances, ensure InfluxDB 3 is running on the expected port. For cloud instances, check network connectivity and firewall rules.

INFLUX_DB_PRODUCT_TYPE mismatch errors

Set INFLUX_DB_PRODUCT_TYPE to exactly one of: 'core', 'enterprise', 'cloud-serverless', 'cloud-dedicated', or 'cloud-clustered'. Using the wrong type causes the server to send incompatible API requests.

Frequently Asked Questions about InfluxDB 3

What is InfluxDB 3?

InfluxDB 3 is a Model Context Protocol (MCP) server that ๐ŸŽ–๏ธ ๐Ÿ“‡ ๐Ÿ  โ˜๏ธ - official mcp server for influxdb 3 core/enterprise/cloud dedicated It connects AI assistants to external tools and data sources through a standardized interface.

How do I install InfluxDB 3?

Follow the installation instructions on the InfluxDB 3 GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with InfluxDB 3?

InfluxDB 3 works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is InfluxDB 3 free to use?

Yes, InfluxDB 3 is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.

Browse More Databases MCP Servers

Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "influxdb3": { "command": "npx", "args": ["-y", "influxdb3"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide โ†’

Ready to use InfluxDB 3?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides