Managing Kubernetes applications with Argo CD provides powerful GitOps capabilities. However, interacting with Argo CD often involves switching contexts – moving between your integrated development environment (IDE) like VS Code and Cursor, the Argo CD UI, and the command line. What if you could manage and query your Argo CD applications directly from your development environment using natural language?

The rise of AI coding assistants in IDEs has significantly changed developer workflows. The Model Context Protocol (MCP) enables AI assistants to securely interact with external tools. Now, you can leverage this integration for your Argo CD workflows with the open-source Argo CD MCP Server.

What is the Argo CD MCP Server?

The Argo CD MCP Server acts as a bridge between MCP supported AI assistants to your Argo CD instance. . Instead of crafting Argo CLI commands or navigating the UI, you can make requests for your AI assistant, such as:

• "List all applications in the production project."

• "What's the sync status of the my-app application?"

• "Show me the resource tree for guestbook."

• "Sync the staging-app."

This server translates these natural language requests into the appropriate Argo CD API calls which brings the results back into your chat interface, streamlining your interaction with your GitOps environment.

Benefits of the Argo CD MCP Server for Dev Teams  

Integrating Argo CD with AI assistants through MCP offers tangible benefits for developers and platform teams:

• Boost Productivity: Get quick answers and perform Argo CD actions without leaving your IDE, minimizing context switching.

• Simplify Interaction: Use natural languages to query application status, view resources, or trigger syncs, making Argo CD more accessible.

• Seamless IDE Workflow: Keep your focus within your primary development environment (VS Code, Cursor, etc.) for a smoother experience.

• Foundation for Automation: Provides a building block for creating more sophisticated AI-driven GitOps automations and workflows in the future.

This open-source tool aims to make interacting with Argo CD faster and more intuitive within modern development practices.

Key Features & Available Tools

The server offers a comprehensive toolkit that supports all core Argo CD features, including application management, high-level status retrieval, and access to all managed resources. This enables the AI to gather complete application context and generate meaningful, informed suggestions. Additionally, the server includes Kubernetes-specific tools for advanced use cases—for example, fetching workload logs or discovering and executing resource actions configured in Argo CD.

These tools allow for extensive observation and management of Argo CD applications and their resources directly via your AI assistant.

The complete set of tools available in this initial release of the MCP server is listed below:

• Application Management

  • list_applications

  • get_application

  • create_application

  • update_application

  • delete_application

  • sync_application

    
    

• Resource Management: 

  • get_application_resource_tree

  • get_application_managed_resources

  • get_application_workload_logs

  • get_resource_events

  • get_resource_actions

  • Run_resource_action

See the Argo CD MCP Server in Action

See the Argo CD MCP Server in action! This short demo shows how you can create and sync an Argo CD application using simple, natural language commands directly within your AI assistant's chat interface.

How to Get Started with the Argo CD MCP Server

Integrating the Argo CD MCP server into your workflow is a straightforward process, and here’s how to get started.

Prerequisites

• Node.js (v18+)

• An Argo CD instance with API access (URL and an authentication token)

• An AI assistant that supports MCP (e.g., VS Code, Cursor, Claude)

Example Configuration (for VS Code in .vscode/mcp.json)

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

(Configuration examples for VS Code and Claude Desktop are available in the project README)

Once configured, your MCP-compatible AI assistant can start using the available Argo CD tools.

FAQs About the MCP Server

Q: What are the prerequisites for using Argo CD MCP Server?

A: You need Node.js (v18 or higher) and an Argo CD instance with API access.

Q: Can I use Argo CD MCP Server with Visual Studio Code?

A: Yes! You can integrate it with Visual Studio Code by following the MCP server documentation.

Q: Is there support for other transport protocols?

A: Yes, it supports both stdio and SSE transport modes.

Ready to try the Argo CD MCP Server?

The Argo CD MCP Server, created by Akuity, the original creators of the Argo Project, is now available on GitHub: https://github.com/akuity/argocd-mcp. For questions, discussions, and to connect with other users and the maintainers, join the Akuity Community Discord server.

If you're interested in other helpful tools created by the minds behind the Argo Project, try out the Akuity Platform today for a supercharged Argo CD experience. Request a demo here for more details.

This server can become an indispensable tool for anyone practicing GitOps with Argo CD in AI-assisted development environments. We encourage you to try it out, explore its capabilities, provide feedback, and contribute to its evolution. Let's enhance the GitOps experience together!