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
- Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
hermes plugins install myfolks - Said no? Turn it on later:
hermes plugins enable myfolks - 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_callpre_gateway_dispatchpre_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

Full setup & settings ↗Source code ↗
More in memory & notes
New Hermes Agent updates every day on X. Follow @HermesWatcher