Hermes Notion GBrain

What Hermes Notion GBrain does

Send a message such as "Follow up with the vendor sales rep on Thursday" and the agent infers a task request, detects the project, converts the relative date to YYYY-MM-DD, creates the task under the matching Notion project and confirms with a check mark. Other messages mark a task done, list pending tasks, move a due date or archive a task. Intent is inferred from natural language through the system prompt, with no explicit commands.

notion_tasks.py is a thin wrapper over the Notion REST API. Every Sunday, gbrain_enrichment.py queries Notion for tasks edited in the last seven days, groups them by project, sends each group to OpenAI gpt-4o-mini for distillation and writes one summary page per project to GBrain, reading the OpenAI key from GBrain's config. The README's example setup runs Hermes on an AWS VPS.

Key features

• Natural-language task creation from WhatsApp or Slack
• Project detection and relative-date conversion
• Mark done, list pending, reschedule and archive by message
• Weekly cron job that writes project summaries to GBrain
• Thin Python wrapper over the Notion REST API

When to use it

• Capture tasks by texting your Hermes agent on WhatsApp
• Keep a Notion task database updated without opening Notion
• Build up project context in GBrain from weekly task activity

Who it is for: Hermes Agent users on a VPS who manage tasks in Notion and keep a GBrain knowledge graph.

How it fits with Hermes Agent

Packaged as a Hermes skill placed under ~/.hermes/skills/productivity/notion-tasks, using Hermes' WhatsApp and Slack interfaces and a cron job.

How to install Hermes Notion GBrain

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

mkdir -p ~/.hermes/skills/productivity/notion-tasks/scripts
cp notion-tasks/notion_tasks.py ~/.hermes/skills/productivity/notion-tasks/scripts/
cp notion-tasks/gbrain_enrichment.py ~/.hermes/skills/productivity/notion-tasks/scripts/

Requirements: Hermes on a VPS (Ubuntu recommended), GBrain installed and initialised, a Notion task database with an integration token, an OpenAI API key configured in GBrain, and Python 3.11+ with requests

Note: The Notion token, database ID, project page IDs and GBrain path are edited directly into the scripts.

FAQ