About
MCP server for Portainer container management
README
Portainer container/stack management
Install
pip install clr-portainer-mcp
# or
uvx clr-portainer-mcp
Configuration
Preferred: Configuration file at ~/.config/portainer/credentials.json (chmod 600):
{
"url": "https://portainer.example.com",
"token": "your-api-token",
"username": "admin",
"password": "your-password"
}
Note: Either token OR username/password is required.
Alternative: Environment variables are also supported:
| Variable | Description | Example |
|---|---|---|
PORTAINER_URL |
Portainer URL | https://portainer.example.com |
PORTAINER_TOKEN |
API token | your-api-token |
PORTAINER_USERNAME |
Username (if not using token) | admin |
PORTAINER_PASSWORD |
Password (if not using token) | your-password |
Optional:
| Variable | Description | Default |
|---|---|---|
PORTAINER_READ_ONLY |
Run in read-only mode | false |
PORTAINER_TRANSPORT |
Transport protocol (stdio or http) |
stdio |
PORTAINER_LOG_LEVEL |
Log level | INFO |
See --help for additional options:
clr-portainer-mcp --help
Development
git clone https://github.com/clearminds/clr-portainer-mcp.git
cd clr-portainer-mcp
uv sync
uv run clr-portainer-mcp
License
MIT
Install Clr Portainer in Claude Desktop, Claude Code & Cursor
unyly install clr-portainerInstalls into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.
First time? Get the CLI: curl -fsSL https://unyly.org/install | sh
Or configure manually
Run in your terminal:
claude mcp add clr-portainer -- uvx clr-portainer-mcpStep-by-step: how to install Clr Portainer
FAQ
Is Clr Portainer MCP free?
Yes, Clr Portainer MCP is free — one-click install via Unyly at no cost.
Does Clr Portainer need an API key?
No, Clr Portainer runs without API keys or environment variables.
Is Clr Portainer hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Clr Portainer in Claude Desktop, Claude Code or Cursor?
Open Clr Portainer on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectAmap Maps Mcp Server
MCP server for using the AMap Maps API
by duxiaohuiSupabase
Database, auth and storage
by SupabaseEverything
Reference / test server with prompts, resources, and tools.
Git
Tools to read, search, and manipulate Git repositories.
Sequential Thinking
Dynamic and reflective problem-solving through thought sequences.
Time
Time and timezone conversion capabilities.
Compare Clr Portainer with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs