drio
Open app

ArgoCD MCP Server

Source

An MCP (Model Context Protocol) server that integrates with the ArgoCD API, enabling agentic tools to manage ArgoCD through natural language interactions.

Catalog onlyCatalog onlySTDIO

Overview

ArgoCD MCP Server is a Model Context Protocol (MCP) server that integrates with the ArgoCD API, allowing AI assistants and large language models to manage ArgoCD applications and resources through natural language interactions.

To use the ArgoCD MCP Server, clone the repository, set up a virtual environment, install dependencies, and start the server using environment variables for configuration. You can connect with AI assistants like Claude to manage your ArgoCD applications.

  • Authentication & Session Management: Token-based authentication, user info retrieval, and server settings access. - Application Management: Create, update, delete, and sync applications with detailed information retrieval. - Robust API Client: Intelligent endpoint handling, comprehensive error handling, and configurable timeouts. - Developer Experience: Full static type checking, detailed documentation, and environment-based configuration.
  1. Managing ArgoCD applications through natural language queries.
  2. Automating application deployment and synchronization tasks.
  3. Integrating with AI assistants for enhanced user interaction with ArgoCD.

Add to your AI client

Use these steps to connect ArgoCD MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "argocd-mcp-severity1": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-argocd-mcp-severity1"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "argocd-mcp-severity1": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-argocd-mcp-severity1"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "argocd-mcp-severity1": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-argocd-mcp-severity1"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "argocd-mcp-severity1": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-argocd-mcp-severity1"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "argocd-mcp-severity1": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-argocd-mcp-severity1"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "argocd-mcp-severity1": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-argocd-mcp-severity1"
      ]
    }
  }
}

FAQ

Can I use ArgoCD MCP Server with any AI assistant?

Yes! It is designed to work with AI assistants that can interact with the MCP protocol.

Is there a specific version of Python required?

Yes, Python 3.12 or higher is required to run the server.

How do I troubleshoot issues with the server?

Check the server logs for errors, ensure all environment variables are set correctly, and refer to the documentation for common troubleshooting steps.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":3092,"uuid":"98681170-75c5-47a8-b817-5fab5af3e640","name":"argocd-mcp","title":"ArgoCD MCP Server","description":"An MCP (Model Context Protocol) server that integrates with the ArgoCD API, enabling agentic tools to manage ArgoCD through natural language interactions.","avatar_url":"https://avatars.githubusercontent.com/u/1973846?v=4","created_at":"2025-03-17T11:27:53.329Z","updated_at":"2025-03-18T15:14:08.660Z","status":"created","author_name":"severity1","author_avatar_url":"https://avatars.githubusercontent.com/u/1973846?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/severity1/argocd-mcp","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/ac892e3817eb6a9c9d3342be0cde3db8be518803e934d938046faece231ece53/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d302e312e302d626c7565","type":null,"metadata":"{\"star\":\"6\",\"license\":\"MIT license\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-04-21 08:55:53\"}","user_uuid":"6031bff6-8a8c-4263-ac46-2831f67a244d","tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools