Hermes
Connect Gurusup to Hermes Agent by installing its plugin from the Hermes catalog and adding the Gurusup server with OAuth.
For any member of a Gurusup organization. Hermes is not listed on the Gurusup MCP page yet, so this page has everything you need.
Before you start
- You have an account in a Gurusup organization.
- Hermes Agent is installed. Run
hermes --versionin a terminal to check. - You use a terminal you can type into. The sign-in opens your browser and Hermes waits for you there, so it does not work from a script or a pipe.
Connect Hermes
Installing the plugin alone is not enough. The plugin brings the skill that tells Hermes when to use Gurusup, but Hermes only signs in to a server you add yourself. Without step 3, every call to Gurusup fails with a 401 error.
Install the plugin
Install Gurusup from the Hermes catalog:
hermes plugins install gurusup-brain
Hermes shows what the plugin does and asks you to confirm. It installs disabled.
Enable it
hermes plugins enable gurusup-brain
If you run the Hermes gateway, restart it with hermes gateway restart.
Add the server and sign in
Keep the name gurusup-brain, so it matches the plugin:
hermes mcp add gurusup-brain --url https://mcp.brain.gurusup.com/mcp --auth oauth
A sign-in page opens in your browser. Sign in with the account you use for Gurusup. If you belong to more than one organization, choose it at this step.
Check that it worked
Test the server
Run hermes mcp test gurusup-brain. It connects and lists the Gurusup tools.
Ask a question that needs two sources
Ask something only your joined sources can answer. With Linear and Slack connected, for example: "Which open Linear issues block the next release, and what did the team decide about them in Slack?" Hermes asks Gurusup and answers from what it returns. See Ask questions.
If it does not work
| What you see | What to do |
|---|---|
| "non-interactive environment and no cached tokens found" | Run the command in a terminal you type into, or run hermes mcp login gurusup-brain there. |
| Calls to Gurusup fail with 401 | Step 3 is missing or the sign-in did not finish. Run hermes mcp login gurusup-brain. |
| For anything else, see MCP troubleshooting. |