PlugWiki
timestream-for-influxdb-mcp-server logo

Amazon Timestream for InfluxDB MCP Server: Setup for Claude, Cursor and Other Apps

Official · by Amazon Web ServicesLocal
GetPyPIawslabs.timestream-for-influxdb-mcp-serverawslabs/mcp/tree/HEAD/src/timestream-for-influxdb-mcp-server

Lets your AI assistant manage Amazon Timestream for InfluxDB and query the time-series data inside InfluxDB.

This AWS Labs server runs on your computer. It uses your AWS credentials to manage Timestream for InfluxDB instances and clusters, and an InfluxDB URL and token to query and write data.

It starts read-only. Setting ALLOW_WRITE to true unlocks the tools that create, change, write and delete.

Good for

  • Engineers running Timestream for InfluxDB who want to check instances and clusters by asking
  • Analysts querying time-series metrics with Flux without writing the query by hand
  • Teams that want read-only access first and writes only on demand

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install timestream-for-influxdb-mcp-server

Claude Code

  1. 1

    Copy this prompt.

    Add the timestream-for-influxdb-mcp-server server to Claude Code. Run this command:
    
    claude mcp add timestream-for-influxdb -- uvx awslabs.timestream-for-influxdb-mcp-server
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires uv (Python).

Built from the package data we hold. Not yet tested by us.

Tools

  • Lists your Timestream for InfluxDB instances

    Returns every database instance in your account and region.

    Try: “List my Timestream for InfluxDB instances.”

    Network · ListDbInstances

  • Shows the details of one instance

    Returns the configuration and status of a single DB instance.

    Try: “Show me the details of the metrics-prod instance.”

    Network · GetDbInstance

  • Lists instances in a given state

    Returns only the DB instances whose status matches, for example available or deleting.

    Try: “Which instances are not available right now?”

    Network · LsInstancesByStatus

  • Lists your database clusters

    Returns every DB cluster in your account and region.

    Try: “List my Timestream for InfluxDB clusters.”

    Network · ListDbClusters

  • Shows the details of one cluster

    Returns the configuration and status of a single DB cluster.

    Try: “Describe the cluster metrics-cluster.”

    Network · GetDbCluster

  • Lists clusters in a given state

    Returns only the DB clusters whose status matches.

    Try: “Show clusters that are still creating.”

    Network · ListClustersByStatus

  • Lists the instances inside a cluster

    Returns the DB instances that belong to one cluster.

    Try: “Which instances make up metrics-cluster?”

    Network · LsInstancesOfCluster

  • Lists parameter groups

    Returns the DB parameter groups in your account.

    Try: “List my DB parameter groups.”

    Network · ListDbParamGroups

  • Shows one parameter group

    Returns the settings of one DB parameter group.

    Try: “Show the settings in the default parameter group.”

    Network · GetDbParameterGroup

  • Shows the tags on a resource

    Lists the tags on an instance, cluster or other resource.

    Try: “What tags does metrics-prod have?”

    Network · ListTagsForResource

  • Runs a Flux query on InfluxDB

    Queries InfluxDB data with the Flux language. Queries that write, such as to(), are rejected unless INFLUXDB_WRITE_MODE is on.

    Try: “Show the average CPU per host over the last hour from the telemetry bucket.”

    Network · InfluxDBQuery

  • Lists the buckets in InfluxDB

    Returns the buckets in the InfluxDB instance.

    Try: “List my InfluxDB buckets.”

    Network · InfluxDBListBuckets

Read from the source code

Permissions

low risk · 3 things to watch

Low risk

By default the assistant can list your instances and clusters and run read-only Flux queries. Keep ALLOW_WRITE off and use a read-only InfluxDB token unless you need changes.

What it can do

Watch out for

  • ALLOW_WRITE enables deleting instances and clusters

    It is off by default. With it on, the assistant can delete a database instance or cluster and its data, so use a narrow IAM policy and turn it on only for the task. github.com

  • Your InfluxDB token may reach more than you intend

    Use a read-only InfluxDB token for general use, as the README advises. Calls to other URLs must be on the INFLUXDB_ALLOWED_URLS list. github.com

  • Query results go to your AI provider

    Time-series data the assistant reads is sent to the model. Query only data you can share. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyRead-only is the default. Set the ALLOW_WRITE environment variable to true to enable create, update, delete and write tools. INFLUXDB_WRITE_MODE separately allows writes inside Flux queries.
Talks toAmazon Timestream for InfluxDB in your AWS region. The InfluxDB endpoint you configure (INFLUXDB_URL)
Sign-in and keysUses your AWS credentials from a named AWS profile (AWS_PROFILE) and AWS_REGION, plus INFLUXDB_URL, INFLUXDB_TOKEN and INFLUXDB_ORG for data access.
Scopes
  • Timestream for InfluxDB read actions in AWS

  • An InfluxDB v2 token for the data tools

Questions

Can it delete my database instances?

Only if you turn on ALLOW_WRITE. By default every create, update, delete and write tool is refused without calling AWS or InfluxDB.

How do I run it read-only?

Leave ALLOW_WRITE unset or false, which is the default. Also leave INFLUXDB_WRITE_MODE off so Flux queries cannot write.

Do I need an InfluxDB token?

Only for the data tools that query or write InfluxDB. The AWS management tools use your AWS credentials. The README advises a read-only token for general use.

Can it write data to InfluxDB?

Yes, with ALLOW_WRITE on. It can write points and line protocol and create buckets and organizations. A query cannot write unless INFLUXDB_WRITE_MODE is also on.

Can the assistant point it at a different InfluxDB server?

Only at one you approve. A URL given in a tool call must match INFLUXDB_URL or an entry in INFLUXDB_ALLOWED_URLS.

Does it run in the cloud or on my computer?

On your computer, with your own AWS credentials and InfluxDB token.

Information

updated Nov 2, 2026

Publisher
Amazon Web Services (official)
Package
awslabs.timestream-for-influxdb-mcp-server
Registry
PyPI
Transport
stdio
License
Apache-2.0
Last commit
Oct 30, 2026
Open issues
143
Listed in
Docker MCP Catalog

GitHubDockerDocker MCP Catalog

Other AWS MCP servers

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 2
  1. Timestream for InfluxDB MCP Server README · github.com
  2. Timestream for InfluxDB server source · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.