MyFolks for Hermes

From its catalog listing

Persistent, exact memory about the people in your life. myfolks, /myfolks or /contacts saves and returns details word for word, with when and where each was saved; saving and recall never call a model. Plain words (remember, fix, forget, undo), a Desktop page to search, add, edit, delete and undo, vCard and CSV import, and optional Google Contacts sync. Encrypted SQLite store (AES-256-GCM) in the Hermes folder. Owner only by default, group chats refused, optional per-person sharing (read or add).

Good to know before installing

no network calls until the owner runs myfolks sync; after that Hermes calls the Google People API (people.googleapis.com, contacts.readonly) for the plugin through its declared oauth client (signed in with hermes auth add myfolks:google, token stored and refreshed by Hermes, never given to the plugin), on each sync and automatically at most every 10 minutes when a save or lookup names someone not yet stored, until myfolks sync off. Replies sent over a messaging platform pass through that platform. AI access is off by default; when turned on, the details it needs are sent to the configured model provider. Hooks: pre_gateway_dispatch answers the owner's (and listed shared people's) MyFolks messages in chat apps before the session sees them; pre_llm_call stops a MyFolks command from reaching the AI; pre_tool_call blocks AI tools that directly name its files. Other messages get an in-memory text check only. Stores its own device key in a file only the user can read, or in the OS keychain when Python's keyring package is available.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install myfolks
  2. Said no? Turn it on later:
    hermes plugins enable myfolks
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Memory & notes
Maintained by
fresfrida (Community)
Needs
No API keys declared
Adds tools
myfolks_contacts
Adds hooks
pre_tool_call pre_gateway_dispatch pre_llm_call
Works on
macos, linux
Needs Hermes
0.23.1 or newer
Version
1.0.0
In the catalog
2026-11-12

Known issues (from its catalog listing)

  • Google sync needs your own Google Cloud OAuth client (Desktop app, People API on), set as MYFOLKS_GOOGLE_CLIENT_ID and MYFOLKS_GOOGLE_CLIENT_SECRET; file import needs nothing.
  • Tested in Telegram, the Hermes terminal and Hermes Desktop. Other chat apps and Windows are untested.
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in memory & notes

All memory & notes plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins