argocd-mcp MCP Server

An implementation of Model Context Protocol (MCP) server for Argo CD, enabling AI assistants to interact with your Argo CD applications through natural language. This server allows for seamless…

Local serverstdioApache-2.0

What is the argocd-mcp Server?

argocd-mcp is an MCP project maintained in the akuity/argocd-mcp repository. The maintainer describes its purpose as “An implementation of Model Context Protocol (MCP) server for Argo CD, enabling AI assistants to interact with your Argo CD applications through natural language. This…”. Read the project documentation for the complete scope.

Installation

The documented npm package is argocd-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares ARGOCD_BASE_URL, ARGOCD_API_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
list_clusters	List all clusters registered with ArgoCD
get_appproject	Get detailed information about a specific AppProject (project)
list_applications	List and filter all applications
get_application	Get detailed information about a specific application
create_application	Create a new application
update_application	Update an existing application
delete_application	Delete an application
sync_application	Trigger a sync operation on an application
get_application_resource_tree	Get the resource tree for a specific application
get_application_managed_resources	Get managed resources for a specific application
get_application_workload_logs	Get logs for application workloads (Pods, Deployments, etc.)
get_resource_events	Get events for resources managed by an application
get_resource_actions	Get available actions for resources
run_resource_action	Run an action on a resource

How to install the argocd-mcp Server

{
  "mcpServers": {
    "argocd-mcp": {
      "command": "npx",
      "args": [
        "argocd-mcp@latest",
        "stdio"
      ],
      "env": {
        "ARGOCD_BASE_URL": "<argocd_url>",
        "ARGOCD_API_TOKEN": "YOUR_ARGOCD_API_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
ARGOCD_BASE_URL	Declared in the maintainer’s client configuration.	Check documentation
ARGOCD_API_TOKEN	Declared in the maintainer’s client configuration.	Check documentation