
Amazon Timestream for InfluxDB MCP Server: Setup for Claude, Cursor and Other Apps
awslabs.timestream-for-influxdb-mcp-serverawslabs/mcp/tree/HEAD/src/timestream-for-influxdb-mcp-serverLets 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.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install timestream-for-influxdb-mcp-server
Claude Code
- 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
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 ·
ListDbInstancesShows 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 ·
GetDbInstanceLists 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 ·
LsInstancesByStatusLists your database clusters
Returns every DB cluster in your account and region.
Try: “List my Timestream for InfluxDB clusters.”
Network ·
ListDbClustersShows the details of one cluster
Returns the configuration and status of a single DB cluster.
Try: “Describe the cluster metrics-cluster.”
Network ·
GetDbClusterLists clusters in a given state
Returns only the DB clusters whose status matches.
Try: “Show clusters that are still creating.”
Network ·
ListClustersByStatusLists the instances inside a cluster
Returns the DB instances that belong to one cluster.
Try: “Which instances make up metrics-cluster?”
Network ·
LsInstancesOfClusterLists parameter groups
Returns the DB parameter groups in your account.
Try: “List my DB parameter groups.”
Network ·
ListDbParamGroupsShows one parameter group
Returns the settings of one DB parameter group.
Try: “Show the settings in the default parameter group.”
Network ·
GetDbParameterGroupShows the tags on a resource
Lists the tags on an instance, cluster or other resource.
Try: “What tags does metrics-prod have?”
Network ·
ListTagsForResourceRuns 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 ·
InfluxDBQueryLists the buckets in InfluxDB
Returns the buckets in the InfluxDB instance.
Try: “List my InfluxDB buckets.”
Network ·
InfluxDBListBucketsLists the organizations in InfluxDB
Returns the organizations in the InfluxDB instance.
Try: “Which InfluxDB organizations exist?”
Network ·
InfluxDBListOrgsCreates a database instance
Creates a new Timestream for InfluxDB instance. Needs ALLOW_WRITE.
Try: “Create a small InfluxDB instance called metrics-test.”
Write ·
CreateDbInstanceCreates a database cluster
Creates a new Timestream for InfluxDB cluster. Needs ALLOW_WRITE.
Try: “Create a cluster called metrics-cluster.”
Write ·
CreateDbClusterCreates a parameter group
Creates a new DB parameter group. Needs ALLOW_WRITE.
Try: “Create a parameter group for metrics.”
Write ·
CreateDbParamGroupChanges an instance's settings
Updates the configuration of a DB instance. Needs ALLOW_WRITE.
Try: “Increase the storage on metrics-prod.”
Write ·
UpdateDbInstanceChanges a cluster's settings
Updates the configuration of a DB cluster. Needs ALLOW_WRITE.
Try: “Change the maintenance window on metrics-cluster.”
Write ·
UpdateDbClusterAdds tags to a resource
Adds tags to an instance, cluster or other resource. Needs ALLOW_WRITE.
Try: “Tag metrics-prod with team=data.”
Write ·
TagResourceRemoves tags from a resource
Removes tags from a resource. Needs ALLOW_WRITE.
Try: “Remove the team tag from metrics-prod.”
Write ·
UntagResourceWrites data points to InfluxDB
Writes points to a bucket. Needs ALLOW_WRITE.
Try: “Write a point for host web-1 with cpu 0.42 to the telemetry bucket.”
Write ·
InfluxDBWritePointsWrites line protocol data to InfluxDB
Writes data given in InfluxDB line protocol. Needs ALLOW_WRITE.
Try: “Write this line protocol batch to the telemetry bucket.”
Write ·
InfluxDBWriteLPCreates a bucket in InfluxDB
Creates a new bucket. Needs ALLOW_WRITE.
Try: “Create a bucket named test-data.”
Write ·
InfluxDBCreateBucketCreates an organization in InfluxDB
Creates a new organization. Needs ALLOW_WRITE.
Try: “Create an InfluxDB organization named analytics.”
Write ·
InfluxDBCreateOrgDeletes a database instance
Deletes a Timestream for InfluxDB instance. Needs ALLOW_WRITE. Data on it is lost.
Try: “Delete the instance metrics-test.”
Delete ·
DeleteDbInstanceDeletes a database cluster
Deletes a Timestream for InfluxDB cluster. Needs ALLOW_WRITE. Data on it is lost.
Try: “Delete the cluster metrics-cluster.”
Delete ·
DeleteDbCluster
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
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
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-only | Read-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 to | Amazon Timestream for InfluxDB in your AWS region. The InfluxDB endpoint you configure (INFLUXDB_URL) |
| Sign-in and keys | Uses 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 |
|
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
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 2Hide
- Timestream for InfluxDB MCP Server README · github.com
- Timestream for InfluxDB server source · github.com