Influxdb Cloud MCP server

Connect Influxdb Cloud to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Influxdb Cloud MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the write data tool in Influxdb Cloud
  • Use the run task tool in Influxdb Cloud
  • Use the create bucket tool in Influxdb Cloud
  • Use the delete secrets tool in Influxdb Cloud
  • Use the list authorizations tool in Influxdb Cloud
  • Use the list labels tool in Influxdb Cloud

Supported Tools

write_data

Write Data

Write time-series data to an InfluxDB Cloud bucket using **line protocol** format. Each line represents a data point with measurement, optional tags, fields, and an optional timestamp. Line protocol format: `measurement,tag1=val1 field1=val2 timestamp`.

run_task

Run Task

Manually trigger a task run outside of its normal schedule. Optionally specify a time to simulate the scheduled execution.

create_bucket

Create Bucket

Create a new bucket in the organization for storing time-series data. A bucket is a named location with a configurable retention period that determines how long data is kept.

delete_secrets

Delete Secrets

Delete one or more secrets from the organization by their keys.

list_authorizations

List Authorizations

List all API token authorizations in the organization. Each authorization contains permissions that define what the token can access.

list_labels

List Labels

List all labels in the organization. Labels can be applied to buckets, tasks, dashboards, and other resources for grouping and filtering.

list_dashboards

List Dashboards

List a page of dashboards in the organization. Dashboards contain cells with configurable queries and visualization types for monitoring time-series data.

get_telegraf

Get Telegraf Config

Retrieve a specific Telegraf configuration by ID, including the full TOML configuration content.

list_dbrps

List DBRP Mappings

List all database/retention policy (DBRP) mappings for v1 compatibility. DBRP mappings map legacy InfluxDB 1.x database and retention policy pairs to InfluxDB v2 buckets, enabling v1-compatible tools like Grafana to work with InfluxDB Cloud.

update_bucket

Update Bucket

Update an existing bucket's name, description, or retention period.

delete_data

Delete Data

Delete time-series data points from an InfluxDB Cloud bucket within a specified time range. Optionally filter by a predicate expression to target specific measurements or tag values.

create_authorization

Create Authorization

Create a new API token with specific permissions. The token value is only available in the response immediately after creation. Permissions cannot be modified after creation.

list_organizations

List Organizations

List organizations visible to the current API token. Cloud returns only the organization that owns the token. An organization is a workspace for a group of users, and all resources belong to an organization.

get_task

Get Task

Retrieve details of a specific task by its ID, including the Flux script and scheduling configuration.

update_label

Update Label

Update an existing label's name, color, or description.

delete_bucket

Delete Bucket

Permanently delete a bucket and all of its stored time-series data.

delete_dashboard

Delete Dashboard

Permanently delete a dashboard and all its cells.

list_notification_rules

List Notification Rules

List a page of notification rules in the organization. Notification rules check data in the statuses measurement and send messages to notification endpoints when conditions are met.

list_buckets

List Buckets

List a page of buckets in the organization. Buckets are named storage locations for time-series data with configurable retention periods. Supports filtering by name and pagination.

create_telegraf

Create Telegraf Config

Create a new Telegraf agent configuration. The configuration should be in TOML format and define input, processor, and output plugins.

update_telegraf

Update Telegraf Config

Update an existing Telegraf configuration's name, description, or TOML content.

get_organization_members

Get Organization Members

List all members of a specific organization, including their roles and status.

list_telegrafs

List Telegraf Configs

List all Telegraf agent configurations in the organization. Telegraf configurations define how the Telegraf agent collects, processes, and outputs data.

list_checks

List Checks

List a page of monitoring checks in the organization. Checks query data and assign a status level (ok, info, warn, crit) based on specific conditions. Supports threshold checks and deadman checks.

create_dashboard

Create Dashboard

Create a new dashboard for visualizing time-series data.

list_tasks

List Tasks

List a page of scheduled Flux tasks in the organization. Tasks are scheduled Flux scripts that run on a defined frequency to process, transform, or downsample data.

update_dashboard

Update Dashboard

Update an existing dashboard's name or description.

delete_authorization

Delete Authorization

Permanently delete an API token authorization. Any applications using this token will lose access.

delete_telegraf

Delete Telegraf Config

Permanently delete a Telegraf agent configuration.

update_authorization

Update Authorization

Update an authorization's description or toggle its status between active and inactive. Permissions cannot be changed after creation.

list_secrets

List Secret Keys

List all secret keys stored for the organization. Only the keys are returned, not the values. Secrets are stored securely using Vault and can be referenced in Flux scripts.

create_dbrp

Create DBRP Mapping

Create a new DBRP mapping to enable v1-compatible queries against an InfluxDB Cloud bucket. Maps a legacy database/retention policy pair to a v2 bucket.

query_data

Query Data

Execute a **Flux** query against InfluxDB Cloud and return the results. Flux is a functional scripting language that supports complex transformations, aggregations, joins, and custom functions. Results are returned as CSV-formatted data.

update_task

Update Task

Update an existing task's name, description, Flux script, schedule, or status. Can be used to activate/deactivate a task.

delete_task

Delete Task

Permanently delete a scheduled Flux task.

delete_dbrp

Delete DBRP Mapping

Delete a DBRP mapping. v1-compatible tools using this mapping will no longer be able to access the bucket.

get_task_runs

Get Task Runs

List recent runs for a specific task, including their status, scheduled time, and completion details.

list_notification_endpoints

List Notification Endpoints

List a page of notification endpoints in the organization. Notification endpoints define where alert messages are sent (HTTP, Slack, PagerDuty).

create_label

Create Label

Create a new label for organizing and grouping InfluxDB resources.

create_task

Create Task

Create a new scheduled Flux task. Provide a Flux script and either a cron expression or an interval schedule. Common use cases include downsampling, data aggregation, and triggering external actions.

upsert_secrets

Upsert Secrets

Add or update one or more secrets for the organization. Provide key-value pairs where each key is the secret name and each value is the secret content. Secrets can be referenced in Flux scripts using `secrets.get()`.

delete_label

Delete Label

Permanently delete a label. The label will be removed from all associated resources.

get_dashboard

Get Dashboard

Retrieve one dashboard including its cells and labels. Call list_dashboards to discover dashboard IDs.

get_current_user

Get Current User

Retrieve the user associated with the current InfluxDB API token.

get_task_run_logs

Get Task Run Logs

Retrieve task-run log events to diagnose a failed or completed run. Use get_task_runs to discover run IDs.

get_bucket

Get Bucket

Retrieve one bucket and its retention settings. Call list_buckets to discover bucket IDs.

Connect Influxdb Cloud to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Influxdb Cloud in Metorial. In your Metorial portal, enable the Influxdb Cloud MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Influxdb Cloud tools.

Run Influxdb Cloud through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Influxdb Cloud and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Influxdb Cloud tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Influxdb Cloud

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Sentry

Track, manage, and resolve application errors and performance issues. List, query, and bulk-update issues and error events with filters like status, assignment, and tags. Create and manage releases, associate commits, and upload source maps. Configure issue alert rules and metric alert rules with notification actions. Set up cron monitors to detect missed or failed scheduled jobs. Build custom dashboards with configurable widgets. Run ad-hoc Discover queries across errors and transactions for performance analysis. Manage organizations, teams, projects, and members. Provision users via SCIM. Access session replay data.

Bitbucket

Manage Git repositories, pull requests, and CI/CD pipelines on Bitbucket Cloud. Create, fork, and configure repositories within workspaces and projects. Create, review, approve, merge, and decline pull requests with inline code comments. Browse source code, list commits, and manage branches and tags. Trigger, monitor, and manage Bitbucket Pipelines. List workspace members, configure repository default reviewers and branch restrictions, create and manage repository webhooks, and search code across repositories.

Technical notes for Influxdb Cloud

Write and query time-series data with the InfluxDB Cloud TSM/v2 API using line protocol and Flux. Discover organizations and buckets; manage retention, scheduled tasks, dashboards, labels, API-token authorizations, secrets, Telegraf configurations, and DBRP mappings. Inspect monitoring checks, notification endpoints and rules, current-user identity, and task-run logs.

Frequently asked questions

Common questions about connecting Influxdb Cloud to AI agents with Metorial.

  1. How many tools does the Influxdb Cloud MCP server have?
    The Influxdb Cloud MCP server exposes 46 tools, including Write Data, Run Task, Create Bucket. Each one is governed and traced through Metorial.
  2. Influxdb Cloud exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Influxdb Cloud MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Influxdb Cloud and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Influxdb Cloud MCP server yourself or use the hosted gateway.

Connect Influxdb Cloud to production AI agents

See how Metorial gives your team governed access to Influxdb Cloud, with tracing and security controls built in.