OAuth over SSH / Remote Hosts
Some Hermes providers — xAI Grok OAuth , Spotify , and remote MCP servers (Linear, Sentry, Atlassian, Asana, Figma, …) — use a loopback redirect OAuth flow. The
Some Hermes providers — xAI Grok OAuth, Spotify, and remote MCP servers (Linear, Sentry, Atlassian, Asana, Figma, …) — use a loopback redirect OAuth flow. The auth server redirects your browser to so a tiny HTTP listener started by Hermes can grab the authorization code. This works perfectly when Hermes and your browser are on the same machine. …
What this page covers
- TL;DR
- Browser-only remote (Cloud Shell / Codespaces / EC2 Instance Connect)
- Which Providers Need This
- MCP Servers
- Why the listener can't just bind 0.0.0.0
- Step-by-step: single SSH hop
- 1. Start the tunnel from your local machine
- 2. In a separate SSH session, run the auth command
- 3. Open the URL in your local browser
- Step-by-step: through a jump box
- Mosh, tmux, ssh ControlMaster
- Troubleshooting
- bind [127.0.0.1]:56121: Address already in use
- "Could not establish connection. We couldn't reach your app." (xAI)
- xAI authorization timed out waiting for the local callback
- Tokens land in the wrong ~/.hermes
- See Also
Section outline mirrored from the official Hermes Agent documentation. Follow any heading to read the complete text on the source site.
More in Guides & Tutorials
Tips & Best Practices
A quick wins collection of practical tips that make you immediately more effective with Hermes Agent. Each section targets a different aspect — scan the headers
Run Local LLMs on Mac
This guide walks you through running a local LLM server on macOS with an OpenAI compatible API. You get full privacy, zero API costs, and surprisingly good perf
Tutorial: Daily Briefing Bot
Tutorial: Build a Daily Briefing Bot In this tutorial, you'll build a personal briefing bot that wakes up every morning, researches topics you care about, summa
Tutorial: Team Telegram Assistant
Set Up a Team Telegram Assistant This tutorial walks you through setting up a Telegram bot powered by Hermes Agent that multiple team members can use. By the en
Using Hermes as a Python Library
Hermes isn't just a CLI tool. You can import directly and use it programmatically in your own Python scripts, web applications, or automation pipelines. This gu
Use MCP with Hermes
This guide shows how to actually use MCP with Hermes Agent in day to day workflows. If the feature page explains what MCP is, this guide is about how to get val