
Argocd
io.github.asklokeshPublished by GitHub account asklokeshv0.1.0Updated Oct 24, 2026
MCP server for ArgoCD GitOps continuous delivery integration
Overview
An MCP server that connects an AI assistant to ArgoCD, letting it manage GitOps applications, projects, repositories, clusters and sync operations.
- What you can do
- List, create, sync, roll back and delete ArgoCD applications, and read their status and health. Create and configure projects, roles and policies. Add or remove Git and Helm repositories, and register Kubernetes clusters. Create ApplicationSets for template-based multi-cluster deployments. Inspect application health, sync status and resource trees.
- When to use it
- Useful when you run ArgoCD for Kubernetes GitOps delivery and want an assistant to inspect deployment state, trigger or roll back syncs, or set up projects, repositories and clusters from a conversation instead of the ArgoCD UI or CLI.
- Requirements
- Runs locally as a Python package (pip or uvx). Needs network access to an ArgoCD server, its API URL and an API key supplied through environment variables; the README also shows server, auth token and optional TLS certificate settings. Desktop client only.
Installation
In SourceWeft
- Open Argocd in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
ArgoCD MCP Server
Argocd Mcp Server
[GitHub stars] [GitHub forks] [GitHub watchers]
A Model Context Protocol (MCP) server for integrating ArgoCD GitOps continuous delivery tool with GenAI applications, enabling intelligent Kubernetes deployment management.
Features
-
Comprehensive ArgoCD API Coverage:
- Application Management: Create, sync, delete, rollback applications
- Project Management: Configure projects, roles, and policies
- Repository Management: Add/remove Git repositories, Helm charts
- Cluster Management: Register and manage Kubernetes clusters
- Sync Operations: Manual/auto sync, sync windows, hooks
- Health Monitoring: Application health, sync status, resource tree
- RBAC Management: Users, roles, policies, JWT tokens
- GitOps Workflows: Automated deployments from Git commits
- Multi-tenancy: Namespace isolation, project restrictions
- Application Sets: Template-based multi-cluster deployments
-
Authentication Methods:
- JWT Token authentication
- API Token authentication
- OIDC/OAuth2 integration
- LDAP authentication support
-
Enterprise Features:
- Multi-cluster support
- Disaster recovery workflows
- Progressive delivery (Canary, Blue-Green)
- Automated rollback on failures
- Audit logging and compliance
- Resource optimization
- Secret management integration
Installation
Or install from source:
Configuration
Create a .env file or set environment variables:
Quick Start
Basic Usage
Claude Desktop Configuration
Add to your Claude Desktop config:
Available Tools
Application Management
List Applications
Create Application
Sync Application
Get Application Status
Rollback Application
Project Management
Create Project
Repository Management
Add Repository
Add Helm Repository
Cluster Management
Add Cluster
Application Sets
Create ApplicationSet
Health and Monitoring
Get Application Health
Get Resource Tree
Advanced Configuration
Multi-Cluster GitOps
Progressive Delivery
Disaster Recovery
Integration Examples
See the examples/ directory for complete integration examples:
basic_gitops.py- Basic GitOps workflowsmulti_cluster_deployment.py- Multi-cluster application deploymentprogressive_delivery.py- Canary and blue-green deploymentsdisaster_recovery.py- Backup and restore workflowsgenai_gitops.py- AI-powered GitOps automationsecurity_scanning.py- Integration with security tools
Security Best Practices
- Use service accounts with minimal permissions
- Enable RBAC with proper policies
- Implement network policies for cluster isolation
- Use sealed secrets or external secret operators
- Enable audit logging for compliance
- Implement admission controllers for policy enforcement
- Regular security scanning of images and manifests
Error Handling
The server provides detailed error information:
Performance Optimization
- Use application sets for similar apps
- Enable resource caching in ArgoCD
- Implement sync windows to control deployment times
- Use webhook notifications instead of polling
- Optimize manifest generation with Helm/Kustomize
Troubleshooting
Common Issues
-
Sync failures
- Check application logs
- Verify repository access
- Review resource quotas
-
Authentication errors
- Verify token validity
- Check RBAC policies
- Review server connectivity
-
Performance issues
- Check ArgoCD server resources
- Review application count
- Optimize manifest size
Contributing
Contributions are welcome! Please read our contributing guidelines and submit pull requests.
License
MIT License - see LICENSE file for details
Source: README.md at commit 05ac6d5
Tools
0Version history
1- v0.1.0LatestSep 16, 2026
Score
40% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Declare a license in the repository or the registry entry.