Hermes Agent setup guide
Make phone calls from Hermes Agent with ClawCall
To let Hermes Agent make phone calls, add ClawCall as a remote MCP server: put a clawcall entry with our MCP URL and auth: oauth under mcp_servers in ~/.hermes/config.yaml, run hermes mcp login clawcall, and approve the sign-in. Hermes can then call US numbers, get through menus and hold, and tell you what was said. You don’t need a Twilio, Bland or Vapi account.
What you need
- Hermes Agent installed and working in the terminal (
hermes) or through its messaging gateway. - A browser you can sign in with, on the machine running Hermes or reachable from it, for the one-time ClawCall sign-in.
- A ClawCall account, or a new one created during sign-in, which starts with 30 calls or 30 minutes free.
- A real US destination in +1 E.164 format and a clear task for any call you choose to place.
Use a current Hermes Agent install with MCP support, in the terminal or through its messaging gateway. The MCP route needs one browser sign-in; the skill route needs curl where Hermes runs commands. Calls go to US +1 numbers only, one at a time per ClawCall account.
Set up ClawCall in Hermes Agent
https://api.clawcall.dev/mcpAdd ClawCall to your Hermes config
Open
~/.hermes/config.yamland add aclawcallentry undermcp_serverswith ClawCall’s MCP URL andauth: oauth. Hermes handles discovery, client registration and PKCE itself, so there is no client ID, secret or API key to paste.mcp_servers: clawcall: url: "https://api.clawcall.dev/mcp" auth: oauthSign in from a fresh terminal
Run the login from a new terminal rather than inside a running chat: Hermes’s docs note that a running session reloads MCP connections with a 30-second timeout, which is too short for a browser sign-in, while
hermes mcp loginwaits up to 5 minutes.Hermes prints an authorize URL and opens your browser. Sign in to ClawCall; the consent page, titled “Hermes Agent wants to use ClawCall”, asks you to let it read and place calls. Because Hermes receives the result on a local port, ClawCall’s consent page shows it as an unverified AI client sending to a
http://127.0.0.1address; that is expected for Hermes.hermes mcp login clawcallLoad the tools
Start a new
hermessession, or run/reload-mcpin an open one. A messaging gateway picks up config changes on its own.hermes mcp test clawcallshows what the server answered if the tools don’t appear.If Hermes runs on a VPS or another machine, the browser redirect can’t reach it. Paste the full redirect URL back at Hermes’s prompt, or forward the callback port over SSH, as Hermes’s MCP docs describe.
Or install the ClawCall skill instead
If you would rather use an API key than OAuth, install the ClawCall skill from ClawHub, which Hermes supports as a community skills source. Hermes security-scans community skills before installing them. The skill uses
curlto reach ClawCall’s REST API and reads ClawCall’s current API guide before each call.Without a key, an eligible first call issues one and the skill saves it, for example to
~/.config/clawcall/key.json. To use an existing key, putCLAWCALL_API_KEYin~/.hermes/.envand list it underterminal.env_passthroughinconfig.yaml, since Hermes passes only declared variables to some terminal backends. This follows Hermes’s documented pattern; we have not run it end to end. If Hermes’s scan blocks the skill, use the MCP route.hermes skills install clawhub/clawcall-devCheck it before a real call
Ask Hermes for your ClawCall plan and remaining trial allowance without placing a call. With the MCP route, Hermes should list thirteen ClawCall tools.
On a real call, ClawCall works through the phone menu, waits on hold and talks to whoever answers. If the call needs you, loop-in rings your verified phone, briefs you privately and connects you only if you accept. When the call ends, Hermes gets the lifecycle, the network outcome and talk time, plus transcript evidence when actually captured and a temporary recording link when available; it reads the transcript to tell you whether the task was done.
If a call fails, the reason comes back with the call: an unsupported destination means a non-US number, and a concurrent call limit means another call on your account is still running. More fixes are in the docs’ troubleshooting section.
Something not working? See troubleshooting.
Try it
ClawCall’s tool descriptions tell Hermes when a request needs a phone call, so asking for the call is usually enough; naming ClawCall makes the choice explicit.
Using ClawCall, call my phone at +1XXXXXXXXXX. Say this is a test, ask me to confirm I can hear you, then hang up and tell me what was said.
Let it call without asking each time
If Hermes asks for approval before running ClawCall’s tools or the skill’s commands, always allow ClawCall (choose Always at the terminal prompt), so a call can run from dial to report without stopping at each step. In a messaging chat, reply yes when Hermes asks.
Always allow only skips the repeated approval prompts. It does not widen what the two OAuth scopes or the API key can do, and it does not allow bulk or robocall-style calling.
Turn it off
- Remove ClawCall in Hermes Agent.
- In your ClawCall dashboard, open Settings → Connected AI assistants and select Disconnect.
Questions
- Is there a Hermes Agent phone call skill?
- Yes, several. Hermes ships an optional telephony skill (hermes skills install official/productivity/telephony) that places calls through your own Twilio, Bland or Vapi account, and the Hermes Marketplace lists community calling plugins, most of which need a Twilio account. ClawCall needs none of them: add its MCP server, or install the ClawCall skill from ClawHub, and Hermes calls US numbers from ClawCall’s lines. Source: Hermes Agent docs: Telephony skill Source: Hermes Marketplace: hermes-phone plugin Source: ClawHub: ClawCall skill Source: Hermes Agent docs: MCP
- Can Hermes Agent get its own phone number?
- With ClawCall, calls go out from a shared pool of US numbers on Unlimited ($8.99 a month), or from a private reserved caller-ID number of your own on Unlimited Reserve ($14.99 a month). Hermes’s telephony skill can instead search for and buy a Twilio number on your Twilio account and remember it between sessions. Source: ClawCall pricing Source: Hermes Agent docs: Telephony skill
- Can Hermes Agent answer phone calls?
- ClawCall answers calls to your reserved number on Unlimited Reserve Plus ($18.99 a month), following the greeting and instructions you set, and Hermes can read those calls afterwards. Hermes’s own telephony skill says it does not turn Hermes into a real-time inbound phone gateway; it polls a Twilio number for texts instead. The community Hermes Line plugin answers callbacks on your own Twilio number. Source: ClawCall pricing Source: Hermes Agent docs: Telephony skill Source: Hermes Marketplace: Hermes Line
- Can I ask Hermes for a call from Telegram or Slack?
- Yes. Hermes’s messaging gateway runs the same agent from Telegram, Discord, Slack, WhatsApp, Signal and other chats, and a running gateway picks up new MCP servers from config.yaml without a restart. Complete the ClawCall sign-in once with hermes mcp login on the machine running Hermes. Source: Hermes Agent on GitHub Source: Hermes Agent docs: MCP
- How do I remove ClawCall from Hermes Agent?
- Delete the clawcall entry from ~/.hermes/config.yaml (or set enabled: false), remove its saved token in ~/.hermes/mcp-tokens/, and disconnect Hermes in ClawCall’s connected AI assistants settings. If you installed the skill, run hermes skills uninstall clawcall and delete the key from ~/.config/clawcall/key.json or ~/.hermes/.env. Source: Hermes Agent docs: MCP Source: Hermes Agent docs: Skills System Source: ClawCall security
- What does it cost?
- New ClawCall accounts get 30 calls or 30 minutes free, whichever comes first. After that, plans start at $8.99 a month for unlimited calls. The app you connect may need its own plan.
- Do I have to mention ClawCall?
- No. Once it’s connected, your agent uses ClawCall on its own when a request needs a phone call. Naming it is optional.
- What number does the call come from?
- A shared ClawCall number, or your own US number on Unlimited Reserve.
- How long does ClawCall keep transcripts and recordings?
- ClawCall deletes transcripts 7 days after a call ends and recordings 10 minutes after a call ends. Recording URLs are temporary and cannot be renewed after they expire.
Sources
- Hermes Agent docs: MCP
- Hermes Agent docs: Skills System
- Hermes Agent docs: Security
- Hermes Agent on GitHub
- Hermes Agent docs: Telephony skill
- Hermes Marketplace: hermes-phone plugin
- ClawHub: ClawCall skill
- ClawCall: Hosted MCP for AI agents
- ClawCall MCP and API documentation
- ClawCall pricing
- ClawCall security
- Hermes Marketplace: Hermes Line
Give Hermes Agent a phone
New accounts get 30 calls or 30 minutes free, whichever comes first.