Amazon CloudWatch — Claude Code MCP server: what it does
Amazon CloudWatch connects AI agents to CloudWatch metrics, alarms, and log groups. It speeds up root cause diagnostics across AWS infrastructure.
Apache-2.0 ★ 9,939 updated 2026-10-23
Open on GitHubWhat Amazon CloudWatch does
This MCP server exposes AWS operational telemetry directly to troubleshooting agents. It maps CloudWatch endpoints into dedicated tools for metrics retrieval, PromQL execution, alarm analysis, and log searches.
For performance tracking, get_metric_data handles percentiles such as p90 or p99, math expressions, and multi-metric batching. Log analysis includes execute_cwl_insights_batch, which runs Logs Insights queries across multiple AWS regions simultaneously. That tool splits batches into chunks of 50 log groups, caps concurrency at 7 per region, and merges the results. To query enriched AWS vended metrics with PromQL, you must first enable OpenTelemetry via aws cloudwatch start-otel-enrichment.
You can only run this server locally on the host where your LLM client operates. It requires valid AWS credentials preconfigured in environment variables or via aws configure.
What it helps with
- inspect active AWS alarms to pinpoint incident root causes
- query log groups across multiple regions in one batch operation
- extract latency percentiles and evaluate custom metric expressions
- explore time-series telemetry using PromQL selectors
Example prompts for the agent
- Check active CloudWatch alarms and retrieve recent state transitions
- Run a Logs Insights query on
/aws/lambda/backendfor errors in the last hour - Pull p99 latency metrics and recommend alarm thresholds for this service
How to install Amazon CloudWatch
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Amazon CloudWatch
What is required to run the Amazon CloudWatch MCP server?
You need CloudWatch Telemetry enabled in AWS and credentials configured via aws configure or environment variables. The server must run locally on the same host as your client.
What does the Amazon CloudWatch server do?
It gives coding agents direct access to CloudWatch metrics, Logs Insights search tools, PromQL evaluation, and alarm history analysis.
How do PromQL tools handle AWS vended metrics?
Enriched vended metrics require running aws cloudwatch start-otel-enrichment first. Once enabled, tools like execute_promql_query can query histogram data and service labels.