Arlet
Grafana Cloud

Connect Grafana Cloud to Codex

Search, read and write Grafana Cloud from Codex. Arlet links the two through one MCP connection and takes care of keys and authentication.

Enable Grafana Cloud in ArletCodex connection guide (docs)

Arlet makes Grafana's official MCP server available from the AI client you already use. Sign in to Grafana Cloud and choose read, query or write access to complete the connection.

The AI can search and read dashboards, query Prometheus, Loki, Tempo and other data sources, manage alerts, incidents and on-call, and run Assistant investigations. This covers Grafana Cloud stacks, and the available tools are those provided by Grafana's official server.

How to connect Grafana Cloud to Codex

  1. 1

    In the Arlet dashboard, open Integrations → Add an integration and choose Grafana Cloud. Sign in with Link Grafana Cloud, name the connection and click Create.

  2. 2

    In your terminal, run codex mcp add arlet --url https://mcp.arlet.dev/mcp/ to add Arlet as an MCP server.

  3. 3

    Codex detects OAuth support and opens your browser. Sign in with Google and click Allow on the consent screen.

  4. 4

    Once connected, both the CLI and the IDE extension can call Arlet tools (the configuration is shared).

If the browser does not open, run codex mcp login arlet to redo the authentication.

What you can do

Grafana Cloud tools that Codex can call.

  • search_dashboards

    Search dashboards.

  • get_dashboard_summary

    Get a dashboard summary.

  • get_dashboard_panel_queries

    Get the queries behind panels.

  • update_dashboard

    Create or update a dashboard.

  • list_datasources

    List data sources.

  • query_prometheus

    Query Prometheus metrics.

  • query_loki_logs

    Query Loki logs.

  • query_loki_patterns

    Extract log patterns.

  • query_pyroscope

    Query Pyroscope profiles.

  • alerting_manage_rules

    Manage alert rules.

  • list_incidents

    List incidents.

  • create_incident

    Create an incident.

  • get_current_oncall_users

    Get who is on call now.

  • create_annotation

    Add an annotation.

  • create_investigation

    Start an Assistant investigation.

  • ask_assistant

    Ask Grafana Assistant a question.

The tool list follows what Grafana Cloud's official MCP server provides and may change.

Example uses

  • Read a dashboard

    Read a dashboard's panels and queries and explain the current state in words.

  • Correlate logs and metrics

    Confirm an error-rate spike in Prometheus and pull the matching Loki logs to narrow the cause.

  • Handle on-call

    Check who is on call, open an incident and leave annotations.

  • Tune alerts

    List existing alert rules and adjust thresholds or add new rules.

Prompts you can use as-is

  • Read the API Overview dashboard and summarize the current state
  • Find services whose error rate rose in the last 30 minutes in Prometheus and pull the matching error logs from Loki
  • Who is on call right now? Open an incident for the checkout outage
  • List the alert rules for the checkout service and add a p95 latency alert

Use Grafana Cloud with other AI clients