English Français العربية

io.github.woonyong-choi/hermes-agent-mcp

Official registry Health

Operate a local Hermes Agent install over stdio: tasks, cron, config, gateway, doctor. No network.

Source code

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package hermes-agent-mcp
Claude Code 
claude mcp add hermes-agent-mcp -e 'HERMES_HOME=<HERMES_HOME>' -e 'HERMES_MCP_ALLOW_WRITE=<HERMES_MCP_ALLOW_WRITE>' -e 'HERMES_MCP_ALLOW_SHELL=<HERMES_MCP_ALLOW_SHELL>' -- uvx hermes-agent-mcp==0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hermes-agent-mcp": {
            "command": "uvx",
            "args": [
                "hermes-agent-mcp==0.1.1"
            ],
            "env": {
                "HERMES_HOME": "<HERMES_HOME>",
                "HERMES_MCP_ALLOW_WRITE": "<HERMES_MCP_ALLOW_WRITE>",
                "HERMES_MCP_ALLOW_SHELL": "<HERMES_MCP_ALLOW_SHELL>"
            }
        }
    }
}

Environment variables

  • HERMES_HOME Hermes data directory (default ~/.hermes)
  • HERMES_MCP_ALLOW_WRITE Allow state-changing tools (default 1)
  • HERMES_MCP_ALLOW_SHELL Enable the shell tool (default 0)

Frequently asked questions

What is io.github.woonyong-choi/hermes-agent-mcp?

Operate a local Hermes Agent install over stdio: tasks, cron, config, gateway, doctor. No network.

How do I install io.github.woonyong-choi/hermes-agent-mcp?

It runs on your machine. In Claude Code: claude mcp add hermes-agent-mcp -e 'HERMES_HOME=<HERMES_HOME>' -e 'HERMES_MCP_ALLOW_WRITE=<HERMES_MCP_ALLOW_WRITE>' -e 'HERMES_MCP_ALLOW_SHELL=<HERMES_MCP_ALLOW_SHELL>' -- uvx hermes-agent-mcp==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.woonyong-choi/hermes-agent-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.woonyong-choi/hermes-agent-mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.woonyong-choi/hermes-agent-mcp?

It is published by woonyong-choi. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.