Home
Menu

Hermes Agent

Connect Hermes Agent to smiet over MCP, with an OAuth sign-in or an API key.

Hermes Agent is a self-hosted agent from Nous Research. Connect it to smiet and it can capture notes, read your inbox and carry notes out. For the full tool list and example prompts, see AI assistants.

Sign in with OAuth

Hermes takes a callback on your own machine (localhost), so it can sign in to smiet without a key.

1

Add the server

Add smiet to ~/.hermes/config.yaml:

yaml
mcp_servers:
  smiet:
    url: "https://smiet.app/mcp"
    auth: oauth
2

Sign in

Run:

sh
hermes mcp login smiet

Open the link Hermes prints. Sign in to smiet if you need to, check the email next to Signed in as, and click Approve.

3

Reload

In a running session, type /reload-mcp.

Hermes stores the token in ~/.hermes/mcp-tokens/smiet.json.

Use an API key instead

Create a key under Settings → API keys in smiet. It starts with oat_ and is shown once. Put it in ~/.hermes/.env:

sh
SMIET_API_KEY=oat_your_key

Then point the server at it in ~/.hermes/config.yaml:

yaml
mcp_servers:
  smiet:
    url: "https://smiet.app/mcp"
    headers:
      Authorization: "Bearer ${SMIET_API_KEY}"

Hermes fills in ${SMIET_API_KEY} from the .env file, so the key stays out of the config.

Check the connection

sh
hermes mcp test smiet

It shows what smiet answered. The tools appear in Hermes as mcp_smiet_capture, mcp_smiet_get_next_action and so on.

Things to try

Hermes can run scheduled jobs and talk to you over chat apps. Ask it:

Every weekday at 8:00, call get_next_action in smiet and send me the note it returns, with a suggested first step.

When I message you "note: …", capture the text in smiet.

A scheduled job starts without the context of your current chat, so spell out in the prompt that it should use smiet.

Disconnect

In smiet, open Settings → API keys and click Revoke next to the key. With OAuth, the key is named after the client Hermes registered. Then remove the smiet entry from config.yaml.