Invoice Automation with Hermes Agent
Hermes Agent can handle your invoicing once PineBill is connected as an MCP server. Add three lines to ~/.hermes/config.yaml, run hermes mcp login pinebill, and your agent can create invoices and estimates, track time on tasks, email invoices after you approve, and tell you who's overdue.
Setup
PineBill is a remote MCP server (Streamable HTTP) with OAuth sign-in. There's no API key to store.
1. Add the server
In ~/.hermes/config.yaml:
mcp_servers:
pinebill:
url: "https://www.pinebill.app/api/mcp"
auth: oauth
If Hermes is already running, use /reload-mcp to pick up the change.
2. Sign in
hermes mcp login pinebill
Hermes prints an authorize link. Sign in to PineBill, turn on Allow edits if you want the agent to create and send invoices, and click Allow. Leave edits off for a reporting-only agent.
3. Pick the tools
hermes mcp configure pinebill
Choose the tools Hermes should have. For an agent that runs on its own, leave out the delete_* tools, and consider leaving out send_invoice_email and send_estimate_email so sending stays with you. Then confirm everything works:
hermes mcp test pinebill
What to Ask
- "Invoice Acme for 18 hours of backend work at $120 an hour, due in 14 days."
- "Which invoices are overdue, and how much in total?"
- "Start the timer on the Acme API migration task."
- "Stop my timer and invoice this week's hours to Acme."
- "Create an estimate for Lumen Studio: Stripe integration, 24 hours at $120."
- "What did I earn this quarter compared with last quarter?"
Recurring Jobs
Hermes can run tasks on a schedule. Good invoicing candidates are read-only:
- Weekly: overdue invoices with customer, amount and days late.
- Monthly: a draft list of invoices to create from tracked time, sent to you for approval.
- Daily: invoices due in the next three days.
Each scheduled run counts toward PineBill's limits: 120 requests a minute and 2,000 an hour per user across connected apps, and 30 invoice and estimate emails an hour.
Limits Worth Knowing
- The connection works in the first PineBill organization you joined, with your role's permissions.
- PDF download links expire after an hour.
- Bank and card details of your payment methods are never sent to the agent.
- Disconnect from Organization → Connect MCPs in PineBill to revoke access.
Key Takeaways
- Three lines of YAML and one login connect Hermes Agent to PineBill.
- Choose tools deliberately with
hermes mcp configure, especially for unattended runs. - Schedule the reports, approve the sends.
Prefer a different agent? See invoice automation with OpenClaw or managing invoices from Claude Code, Cursor and Codex.
Sources
Last updated: November 2026. Check the Hermes docs for current command options.
Frequently Asked Questions
Does Hermes Agent support remote MCP servers with OAuth?
Yes. Add the server under mcp_servers in ~/.hermes/config.yaml with a url and auth: oauth, then run hermes mcp login. Hermes prints an authorize link, waits for the callback, and caches the tokens under ~/.hermes/mcp-tokens.
Can I choose which PineBill tools Hermes can use?
Yes. Run hermes mcp configure pinebill to pick the tools the agent gets. Leaving out the delete and send tools is a good default for an agent that runs unattended.
Does this use PineBill AI credits?
No. Your Hermes model does the reasoning, so PineBill AI credits aren't used. Connected apps work on every PineBill plan, including the free plan.
What if my Hermes host has no browser?
Open the authorize link Hermes prints on any device with a browser. If the redirect can't reach the Hermes host, set a fixed callback with oauth.redirect_port and forward that port over SSH while you sign in.
