Connect Easypanel to Claude Code

Inspect, deploy, start, stop and read the logs and metrics of projects and services on your own Easypanel server. Add Toolspoke to Claude Code once and it can use 18 Easypanel actions. Your Easypanel credential stays in Toolspoke, and you choose which actions Claude Code may call.

Set it up in Claude Code

Three steps, the first one once for every toolkit you will ever add.

  1. Add Toolspoke to Claude Code

    Run it in your project, then /mcp to sign in

    claude mcp add --transport http toolspoke https://toolspoke.com/mcp

    The sign-in opens in your browser, and Toolspoke asks you to approve it.

  2. Install Easypanel and connect it

    Add Easypanel to a project in your Toolspoke workspace.

    User API key. You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.

    Easypanel URL
    The address you open Easypanel at. It has to be publicly reachable over HTTPS, a private-network address is refused.
    API key
    Easypanel → Settings → Server → Users → Generate API Key for the user this connection should act as. It has that user's project access; a non-admin user only reaches the projects it was granted.
  3. Choose what Claude Code may do

    All 18 actions start on. Switch off any of the 7 actions that change something in Easypanel, and Claude Code gets a refusal if it tries.

What you can ask Claude Code for

A few of the Easypanel actions that only read, so they are safe to try first.

  • List the projects this key's user can access
  • List every accessible project together with its services and their types (app, compose, databases and so on)
  • Read one project with its services and resolved domains
  • Read a Docker Compose service's configuration and deployment state, including its environment

What Claude Code can do in Easypanel

11 actions read, 5 write and 2 delete or permanently change something.

Reads

  • List projects

    List the projects this key's user can access. Takes no arguments, which is why an install tests itself with it; project names are what every other call takes.

  • List projects and services

    List every accessible project together with its services and their types (app, compose, databases and so on). The quickest way to find a service name.

  • Inspect project

    Read one project with its services and resolved domains.

  • Inspect app service

    Read an app service's full configuration and deployment state, source, build, domains, resources and environment variables. The environment usually holds secrets, so this response is never written to the audit log.

  • Inspect compose service

    Read a Docker Compose service's configuration and deployment state, including its environment. Never written to the audit log, for the same reason as inspect_app_service.

  • Get service error

    Read the latest startup error a service reported. The first thing to check when a service will not come up.

  • Query service logs

    Read a service's log lines from the panel's log store, optionally filtered by text, level, stream or time range. Requires log aggregation to be enabled on the panel. Log lines can hold user data, so they are not written to the audit log.

  • Get service metrics

    Read a service's CPU, memory, network and disk usage over time.

  • List actions

    List recent actions, builds, deployments, starts, stops, env changes, optionally for one project or service. Use the id with get_action to read a build log.

  • Get action

    Read one action with its execution log, the build or deploy output. Logs can echo build-time secrets, so this is not written to the audit log.

  • List domains

    List the domain mappings this user can see, optionally for one service.

Writes

  • Deploy app service

    Build and deploy an app service from its configured source. The service restarts on the new build. Watch progress with list_actions.

  • Deploy compose service

    Build and deploy a Docker Compose service from its configured source.

  • Restart app service

    Restart an app service without rebuilding it.

  • Start app service

    Enable and start a stopped app service, without rebuilding it.

  • Stop app service

    Stop and disable an app service. It goes offline until start_app_service is called, but nothing is lost, so it is a write rather than destructive.

Deletes or permanently changes

  • Update app env

    Replace an app service's entire environment with the given .env text. Destructive, not a write: every variable not in the new text is gone, the old values cannot be read back afterwards, and the service picks the change up on its next deploy. Read the current env with inspect_app_service first and send the whole set.

  • Destroy app service

    Permanently delete an app service with its files, domains, backups and image. There is no undo.

Easypanel in Claude Code: questions

Does Claude Code see my Easypanel credential?

No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.

Can I stop Claude Code from changing things in Easypanel?

Yes. Each of the 18 actions can be switched off for a project. Turn off the 7 that change something and Claude Code can only read.

Will 18 actions crowd Claude Code's context?

No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the Easypanel action it needs when it needs it. Adding more toolkits does not add more tools to its list.

Can I add it once for every project?

Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.

What does it cost?

Tool calls are free on every plan, and a Easypanel call does not run in a sandbox, so it bills nothing.

Try Easypanel in Claude Code

Free to start, and tool calls cost nothing on any plan.