← Back to EasyShell

Install EasyShell

Pick your client, copy the command, done.

1

Add it to Claude Code

claude mcp add -e "EASYSHELL_API_KEY=${EASYSHELL_API_KEY}" easyshell -- npx -y @easyshell-ai/easyshell
Required:EASYSHELL_API_KEY

Environment Variables

Set these before running EasyShell.

VariableDescriptionRequired
EASYSHELL_API_KEYAPI key for authenticating with the EasyShell platform.Yes

Available Tools (3)

Once configured, EasyShell gives your AI agent access to:

execute_scriptExecute a shell script on a target host or group of hosts.
scripthoststarget_os
orchestrate_taskDecompose a high-level operational goal into a multi-step execution plan across multiple hosts.
goalhosts
schedule_inspectionConfigure a recurring inspection task with cron expressions and AI-powered output analysis.
cron_expressionscript_idanalysis_promptnotification_rules

Try It Out

After setup, try these prompts with your AI agent:

Check disk and memory usage on all production hosts and flag anything over 80%.
Write a shell script to update all Nginx configurations on my web servers and show me the diff.
Schedule a daily inspection of system logs on the database cluster and alert me if any critical errors are found.
Orchestrate a task to restart the application service across all nodes in the staging environment.
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Node.js 18+ with npm/npx installed
  • EASYSHELL_API_KEY — API key for authenticating with the EasyShell platform.

Keep this setup from going cold

Save the docs, env vars, and workflow around EasyShell in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup