# Invoice Automation with Hermes Agent

> Connect PineBill to Nous Research's Hermes Agent in a few lines of YAML, then create invoices, track time and chase overdue payments from your agent.

- Published: 2026-11-19
- Updated: 2026-11-19
- Category: Guides
- Tags: hermes-agent, mcp, ai-agents, invoice-automation, self-hosted
- Author: Avery Collins, Editor, PineBill Guides
- Source: https://www.pinebill.app/blog/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`:

```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

```bash
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

```bash
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:

```bash
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.

<Callout type="warning">
  An email can't be unsent and a deleted invoice can't be restored. Keep those tools out of unattended jobs.
</Callout>

## 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

1. **Three lines of YAML and one login** connect Hermes Agent to PineBill.
2. **Choose tools deliberately** with `hermes mcp configure`, especially for unattended runs.
3. **Schedule the reports, approve the sends.**

Prefer a different agent? See [invoice automation with OpenClaw](/blog/invoice-automation-with-openclaw) or [managing invoices from Claude Code, Cursor and Codex](/blog/manage-invoices-from-claude-code-cursor-and-codex).

## Sources

* [Hermes Agent Docs — MCP](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp)
* [PineBill Docs — Developer tools](https://www.pinebill.app/docs/mcp/developer-tools)
* [PineBill Docs — Available MCP tools](https://www.pinebill.app/docs/mcp/available-tools)

*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.
