Hermes Agent Mcp

Lets an MCP client operate a local Hermes Agent install over stdio: tasks, cron jobs, config, gateway, doctor and skills.

What you can do

Wraps the local hermes CLI over stdio and exposes around sixteen tools: hermes_ask for a one-shot task, cron list/create/edit/run/runs, typed config_get and config_set against config.yaml, gateway status and restart, doctor, skills_list, sessions_list, model_info, and optional bridge tools that post prompts and replies into a chat. A shell tool exists but is disabled by default. Everything runs as a child process of the MCP client on the same machine, with no network listener.

When to use it

Use it when an MCP-capable assistant on the same machine needs to operate Hermes without a terminal: scheduling or editing cron jobs, changing configuration, restarting the gateway, or running health checks. It is a local alternative to remote Hermes bridges that expose the gateway over HTTP.

Requirements

Python with uv/uvx to run the PyPI package hermes-agent-mcp as a local stdio process. A local Hermes Agent install and its CLI on PATH, or set HERMES_MCP_BIN. Optional environment variables: HERMES_HOME, HERMES_MCP_ALLOW_WRITE, HERMES_MCP_ALLOW_SHELL, HERMES_MCP_TIMEOUT, HERMES_MCP_ASK_TIMEOUT, HERMES_MCP_MAX_OUTPUT, HERMES_MCP_CALLER, HERMES_MCP_LABEL_FORMAT. No network, ports, OAuth or credentials of its own.