InfluxDB MCP Server
A Model Context Protocol server that provides Claude with access to InfluxDB time-series database instances, enabling data writing, querying, and management of organizations and buckets through natural language.
What is InfluxDB MCP Server?
InfluxDB MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that provides claude with access to influxdb time-series database instances, enabling data writing, querying, and management of organizations and buckets through natural ...
A Model Context Protocol server that provides Claude with access to InfluxDB time-series database instances, enabling data writing, querying, and management of organizations and buckets through natural language.
This server falls under the Databases and Monitoring & Observability categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol server that provides Claude with ac
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx influxdb-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use InfluxDB MCP Server
The InfluxDB MCP Server connects Claude to InfluxDB v2 time-series databases, enabling natural language writing and querying of metrics, logs, and telemetry data. It exposes tools for writing line-protocol data, running Flux queries, creating buckets, and managing organizations — making it easy to explore IoT sensor readings, application metrics, or infrastructure data in conversational AI workflows.
Prerequisites
- Node.js 16+ and npm installed
- A running InfluxDB v2 instance (local or InfluxDB Cloud)
- An InfluxDB API token with read/write permissions
- An MCP-compatible client such as Claude Desktop or Claude Code
Obtain an InfluxDB API token
Log in to your InfluxDB UI (default: http://localhost:8086), navigate to Load Data → API Tokens, and generate a token with the appropriate read/write permissions for the organizations and buckets you want to access.
Install the MCP server via Smithery (recommended)
Use the Smithery CLI to install and configure the server automatically for Claude.
npx -y @smithery/cli install @idoru/influxdb-mcp-server --client claudeOr run directly with npx
You can also run the server directly using npx, providing the required token as an environment variable.
INFLUXDB_TOKEN=your_token npx influxdb-mcp-serverConfigure the MCP client manually
Add the server to claude_desktop_config.json with your InfluxDB connection details. INFLUXDB_URL defaults to http://localhost:8086 if not set.
{
"mcpServers": {
"influxdb": {
"command": "npx",
"args": ["influxdb-mcp-server"],
"env": {
"INFLUXDB_TOKEN": "your_influxdb_api_token",
"INFLUXDB_URL": "http://localhost:8086",
"INFLUXDB_ORG": "your_org_name"
}
}
}
}Verify connectivity
After restarting Claude Desktop, ask Claude to list organizations or buckets to confirm the server can reach your InfluxDB instance.
InfluxDB MCP Server Examples
Client configuration
Example claude_desktop_config.json entry for InfluxDB MCP Server.
{
"mcpServers": {
"influxdb": {
"command": "npx",
"args": ["influxdb-mcp-server"],
"env": {
"INFLUXDB_TOKEN": "your_influxdb_api_token",
"INFLUXDB_URL": "http://localhost:8086",
"INFLUXDB_ORG": "myorg"
}
}
}
}Prompts to try
Example prompts once Claude is connected to InfluxDB.
- "Query the last 24 hours of CPU usage from the 'metrics' bucket in the 'myorg' organization"
- "Write a data point to the 'sensors' bucket: temperature=23.5 at the current timestamp"
- "Create a new bucket called 'app-logs' with a 7-day retention policy"
- "List all buckets in my InfluxDB organization"
- "Show me the average memory usage for the past hour using a Flux query"Troubleshooting InfluxDB MCP Server
Authentication error: unauthorized
Verify that INFLUXDB_TOKEN is set correctly and that the token has the necessary permissions (read/write) for the target organization and bucket. Regenerate the token in the InfluxDB UI if needed.
Connection refused when connecting to InfluxDB
Check that INFLUXDB_URL points to the correct host and port where InfluxDB is running. The default is http://localhost:8086 — update this if your instance runs on a different host or port, or if using InfluxDB Cloud (use the cloud URL from your account settings).
Flux query returns no results
Make sure the bucket name, organization name, and time range in your query are correct. InfluxDB bucket names are case-sensitive. Try using a broader time range (e.g., -7d instead of -1h) to confirm data exists.
Frequently Asked Questions about InfluxDB MCP Server
What is InfluxDB MCP Server?
InfluxDB MCP Server is a Model Context Protocol (MCP) server that model context protocol server that provides claude with access to influxdb time-series database instances, enabling data writing, querying, and management of organizations and buckets through natural language. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install InfluxDB MCP Server?
Follow the installation instructions on the InfluxDB MCP Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with InfluxDB MCP Server?
InfluxDB MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is InfluxDB MCP Server free to use?
Yes, InfluxDB MCP Server is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
InfluxDB MCP Server Alternatives — Similar Databases Servers
Looking for alternatives to InfluxDB MCP Server? Here are other popular databases servers you can use with Claude, Cursor, and VS Code.
Excelize
★ 20.6kGo language library for reading and writing Microsoft Excel™ (XLAM / XLSM / XLSX / XLTM / XLTX) spreadsheets
MCP Toolbox for Databases
★ 15.3kOpen source MCP server specializing in easy, fast, and secure tools for Databases.
DBHub
★ 2.8kA universal database gateway MCP server that enables AI assistants to connect to and query multiple databases (PostgreSQL, MySQL, MariaDB, SQL Server, SQLite) with support for schema exploration, SQL execution, and secure connections via SSH tunnels.
Tabularis
★ 2.1kA lightweight, cross-platform database client for developers. Supports MySQL, PostgreSQL and SQLite. Hackable with plugins. Built for speed, security, and aesthetics.
Postgres AI Guide
★ 1.7kMCP server and Claude plugin for Postgres skills and documentation. Helps AI coding tools generate better PostgreSQL code.
Anyquery
★ 1.7k🏎️ 🏠 ☁️ - Query more than 40 apps with one binary using SQL. It can also connect to your PostgreSQL, MySQL, or SQLite compatible database. Local-first and private by design.
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.
Set Up InfluxDB MCP Server in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use InfluxDB MCP Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.