
AWS CloudWatch MCP Server: Setup for Claude, Cursor and Other Apps
Lets your AI assistant read CloudWatch alarms, metrics and logs to find out why something in AWS is failing.
This is an AWS Labs server that runs on your computer and uses your AWS credentials. Its own description says it runs read-only commands to analyze CloudWatch logs, metrics and alarms.
You need an AWS account with CloudWatch data and a profile that can read it. The README says it can only run on the same machine as your AI app.
Good for
- On-call engineers who want the assistant to dig through alarms and logs while they debug
- Platform teams checking metric trends and getting alarm suggestions
- Anyone who wants to query CloudWatch Logs without writing Insights syntax
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 cloudwatch-mcp-server
Claude Code
- 1
Copy this prompt.
Add the cloudwatch-mcp-server server to Claude Code. Run this command: claude mcp add cloudwatch -- uvx awslabs.cloudwatch-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 the CloudWatch alarms that are firing now
Finds the alarms currently in the ALARM state across your account and says which region was checked.
Try: “Which CloudWatch alarms are firing right now in us-east-1?”
Network ·
get_active_alarmsShows how an alarm changed state over time
Returns past state changes for one alarm, so the assistant can spot patterns such as flapping or a repeat time of day.
Try: “Show the history of the HighCPU alarm for the last 3 days.”
Network ·
get_alarm_historyFinds CloudWatch log groups and their settings
Lists log groups and their metadata, optionally filtered by name, so the assistant can pick the right group to look into.
Try: “Find the log groups that belong to my checkout service.”
Network ·
describe_log_groupsLooks for anomalies and error patterns in a log group
Analyzes one log group over a time window and reports anomalies, common message patterns and error patterns.
Try: “Analyze /aws/lambda/orders for errors in the last hour.”
Network ·
analyze_log_groupStarts a Logs Insights query
Starts a Logs Insights query on one or more log groups for a time range. It returns a query ID that you use to fetch the results.
Try: “Query the checkout log group for the 20 slowest requests today.”
Network ·
execute_log_insights_queryFetches the results of a Logs Insights query
Returns the rows of a query started earlier, using its query ID.
Try: “Get the results of the query I just started.”
Network ·
get_logs_insight_query_resultsStops a Logs Insights query that is still running
Cancels a query in progress. It only stops the query and does not touch your logs.
Try: “Cancel that log query, it is taking too long.”
Network ·
cancel_logs_insight_queryRuns one Logs Insights query across many log groups and regions
Runs a single query over many log groups and regions, splits the work, retries failures and merges the rows into one result with warnings.
Try: “Search all my production log groups in us-east-1 and eu-west-1 for ERROR in the last hour.”
Network ·
execute_cwl_insights_batchSuggests field indexes for one log group
Looks at how a log group is queried and recommends fields to index so queries run faster.
Try: “Which fields should I index on the payments log group?”
Network ·
recommend_indexes_loggroupFinds the log groups that would gain most from indexing
Triage across your account: ranks which log groups would benefit from field indexing.
Try: “Which of my log groups should I add indexes to first?”
Network ·
recommend_indexes_accountFetches CloudWatch metric values over time
Retrieves data points for any metric by namespace, dimension and statistic. It can also compute percentiles, math expressions and several metrics in one call.
Try: “Show p99 latency for my API Gateway over the last 6 hours.”
Network ·
get_metric_dataExplains what a CloudWatch metric measures
Returns a description of a metric, how it is calculated and which statistics suit it.
Try: “What does the CPUCreditBalance metric mean?”
Network ·
get_metric_metadataReports trend and seasonality of a metric
Analyzes metric data to find its trend, seasonality and basic statistics.
Try: “Does my Lambda error count show a daily pattern?”
Network ·
analyze_metricSuggests alarm settings for a metric
Proposes alarm thresholds and evaluation periods for a metric from best practice and its own history. It only suggests and creates no alarm.
Try: “Recommend an alarm for the RDS FreeStorageSpace metric.”
Network ·
get_recommended_metric_alarmsRuns a PromQL query at a single point in time
Runs an instant PromQL query against CloudWatch, for metrics sent through OpenTelemetry and enriched AWS metrics.
Try: “Run a PromQL query for the current request rate of service checkout.”
Network ·
execute_promql_queryRuns a PromQL query over a time window
Runs a PromQL range query and returns a time series, for trend analysis.
Try: “Graph the request rate of service checkout over the last day with PromQL.”
Network ·
execute_promql_range_queryLists the values of a PromQL label
Returns values of one label, such as metric names or service names, to help you discover what is there.
Try: “List the service names available in PromQL.”
Network ·
get_promql_label_valuesFinds series that match PromQL label filters
Returns the full label set of every series that matches the selectors you give.
Try: “Find the series for service checkout in PromQL.”
Network ·
get_promql_seriesLists all PromQL label names
Returns the label names available, so the assistant learns the structure of your OpenTelemetry metrics.
Try: “Which PromQL labels exist in my account?”
Network ·
get_promql_labels
Read from the source code
Permissions
low risk · 2 things to watch
Low risk
The assistant can read your alarms, metrics and log text, and no tool in the list creates or deletes anything. Use an AWS profile limited to the CloudWatch read permissions and the log groups you want to share.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
Log lines can contain secrets and personal data
Query results go to your assistant and its provider. Scope the AWS profile to the log groups you are happy to share. github.com
Big queries can be slow and costly
Logs Insights bills by data scanned. Ask for a short time range and a limit, and cancel queries that run long. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | Not needed: the server describes itself as read-only. Give the AWS identity only the permissions the README lists. |
|---|---|
| Talks to | Amazon CloudWatch and CloudWatch Logs in the regions you query |
| Sign-in and keys | Uses your AWS credentials from a named AWS profile (AWS_PROFILE) or the standard AWS credential chain, plus an optional AWS_REGION. |
| Scopes |
|
Questions
Can it create or change alarms?
No. It suggests alarm settings but has no tool that creates, edits or deletes an alarm. It can start and stop Logs Insights queries, which does not change your logs.
Which AWS permissions does it need?
Read access to CloudWatch alarms and metrics, plus the Logs actions to describe log groups and to start, read and stop queries. The README lists eleven actions.
Does it run in the cloud or on my computer?
On your computer. The README says it can only run on the same machine as your AI app, using your own AWS credentials.
Can it search logs in several regions at once?
Yes. One tool runs a Logs Insights query across many log groups and regions in a single call and merges the results.
Do I need to know Logs Insights or PromQL?
No. Describe what you want and the assistant writes the query. PromQL tools matter only if you send OpenTelemetry metrics to CloudWatch.
Information
updated Nov 2, 2026
- Publisher
- Amazon Web Services (official)
- Package
awslabs.cloudwatch-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 5Hide
- CloudWatch MCP Server README · github.com
- CloudWatch server source · github.com
- CloudWatch Logs tools source · github.com
- CloudWatch Metrics tools source · github.com
- CloudWatch Alarms tools source · github.com