Provides comprehensive integration with Argo CD for managing applications, resources, and deployments through GitOps workflows, including application lifecycle management, synchronization, resource monitoring, and workload log retrieval.
Enables management of Kubernetes resources through Argo CD, including access to resource trees, managed resources, events, and the ability to execute actions on Kubernetes workloads and deployments.
Argo CD 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 integration with Visual Studio Code and other MCP clients through stdio and HTTP stream transport protocols.
This project is maintained by Akuity, the creators of Argo Project.
Akuity is the enterprise company for Argo and Kargo, and provides the essential platform for end-to-end GitOps for Kubernetes. With the Akuity Platform, enterprises can deploy with managed Argo CD, promote seamlessly with Kargo, and gain real-time visibility into their infrastructure using Akuity Monitoring. Akuity was founded by Argo creators Hong Wang, Jesse Suen, and Alexander Matyushentsev, with a mission to empower both Platform and Application teams with the best tools for GitOps at enterprise scale.
Features
Transport Protocols: Supports both stdio and HTTP stream transport modes for flexible integration with different clients
Complete Argo CD API Integration: Provides comprehensive access to Argo CD resources and operations
AI Assistant Ready: Pre-configured tools for AI assistants to interact with Argo CD in natural language
Available Tools
The server provides the following ArgoCD management tools:
Application Management
list_applications
: List and filter all applicationsget_application
: Get detailed information about a specific applicationcreate_application
: Create a new applicationupdate_application
: Update an existing applicationdelete_application
: Delete an applicationsync_application
: Trigger a sync operation on an application
Resource Management
get_application_resource_tree
: Get the resource tree for a specific applicationget_application_managed_resources
: Get managed resources for a specific applicationget_application_workload_logs
: Get logs for application workloads (Pods, Deployments, etc.)get_resource_events
: Get events for resources managed by an applicationget_resource_actions
: Get available actions for resourcesrun_resource_action
: Run an action on a resource
Installation
Prerequisites
Node.js (v18 or higher recommended)
pnpm package manager (for development)
Argo CD instance with API access
Argo CD API token (see the docs for instructions)
Usage with Cursor
Follow the Cursor documentation for MCP support, and create a
.cursor/mcp.json
file in your project:
Start a conversation with Agent mode to use the MCP.
Usage with VSCode
Follow the Use MCP servers in VS Code documentation, and create a
.vscode/mcp.json
file in your project:
Start a conversation with an AI assistant in VS Code that supports MCP.
Usage with Claude Desktop
Follow the MCP in Claude Desktop documentation, and create a
claude_desktop_config.json
configuration file:
Configure Claude Desktop to use this configuration file in settings.
Self-signed Certificates
If your Argo CD instance uses self-signed certificates or certificates from a private Certificate Authority (CA), you may need to add the following environment variable to your configuration:
This disables TLS certificate validation for Node.js when connecting to Argo CD instances using self-signed certificates or certificates from private CAs that aren't trusted by your system's certificate store.
Warning: Disabling SSL verification reduces security. Use this setting only in development environments or when you understand the security implications.
Read Only Mode
If you want to run the MCP Server in a ReadOnly mode to avoid resource or application modification, you should set the environment variable:
This will disable the following tools:
create_application
update_application
delete_application
sync_application
run_resource_action
By default, all the tools will be available.
For Development
Clone the repository:
Install project dependencies:
Start the development server with hot reloading enabled:
Once the server is running, you can utilize the MCP server within Visual Studio Code or other MCP client.
Upgrading ArgoCD Types
To update the TypeScript type definitions based on the latest Argo CD API specification:
Download the
swagger.json
file from the ArgoCD release page, for example here is the swagger.json link for ArgoCD v2.14.11.Place the downloaded
swagger.json
file in the root directory of theargocd-mcp
project.Generate the TypeScript types from the Swagger definition by running the following command. This will create or overwrite the
src/types/argocd.d.ts
file:pnpm run generate-typesUpdate the
src/types/argocd-types.ts
file to export the required types from the newly generatedsrc/types/argocd.d.ts
. This step often requires manual review to ensure only necessary types are exposed.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables AI assistants to interact with Argo CD applications through natural language. Provides comprehensive access to Argo CD resources including application management, synchronization, resource monitoring, and GitOps operations.