Skip to main content

​
Use Hermes Agent with Marrow MCP

Hermes Agent is an open-source, self-hosted AI agent created by Nous Research. Unlike standard AI chat assistants, such as ChatGPT, that start from scratch with every conversation, Hermes is an autonomous agent designed to remember its experiences and learn over time. It supports a desktop app, CLI and TUI interfaces. In this setup, Marrow MCP acts as the data layer for Hermes. Your agent calls Marrow tools to read live Amazon Seller, Vendor, and Ads data on demand, without manual exports or custom SP-API pipelines.

​
What you will build

By the end of this tutorial, you will have:
  • Hermes Agent installed and running on your machine with the desktop UI
  • an Anthropic LLM configured with your own API key
  • Marrow MCP connected through the mcp-remote proxy in config.yaml
  • a verified first conversation that queries your Amazon seller data
  • a concrete 7-day sales report for the example seller account, generated inside Hermes chat

​
Prerequisites

  • A Marrow account with your Amazon connections set up and synced.
  • A Marrow MCP key. If you have not created one yet, follow the Marrow MCP Overview guide first, then return here. You can also create a key directly in Marrow MCP Integrations.
  • An Anthropic API key. Sign up at console.anthropic.com and create a key under API Keys.
  • Node.js 18 or later, which is required for the mcp-remote proxy. Verify your version with node --version.

​
Step 1: Install Hermes

  1. Download the Hermes desktop installer for your operating system from hermes-agent.nousresearch.com.
  2. Run the installer and open the Hermes desktop app.
  3. Follow the initial onboarding prompts. You can skip the Nous Portal step because you will configure your own Anthropic key in the next step.
Hermes desktop app - welcome screen

​
Step 2: Configure an Anthropic LLM

Hermes supports many LLM providers. This tutorial uses claude-sonnet-4-6 via a direct Anthropic API key, configured through the Hermes CLI. In your terminal, run:
This launches the interactive model picker. Follow the steps below.

​
Select provider: Anthropic

Use the arrow keys to navigate to Anthropic (Claude models via API key or Claude Code) and press ENTER to select it. hermes model - provider selection list with Anthropic highlighted

​
Choose authentication method: API key

Hermes asks how to authenticate with Anthropic. Select option 2: Anthropic API key (pay-per-token). Hermes - choose authentication method Hermes - entering choice 2 for API key

​
Enter your Anthropic API key

Hermes prompts for the key and shows where to create one:
Paste your key from console.anthropic.com/settings/keys and press ENTER. Hermes - API key input prompt
Already have credentials stored? If you have previously authenticated, Hermes shows a Use existing credentials / Reauthenticate prompt instead. Choose Use existing credentials to skip re-entry.
Hermes - existing credentials prompt

​
Select the default model: claude-sonnet-4-6

Pick claude-sonnet-4-6 from the model list, using / to search, and press ENTER. Hermes marks it as the default and writes the selection to ~/.hermes/config.yaml. Hermes - model selection list with claude-sonnet-4-6 The resulting section in ~/.hermes/config.yaml:
Already inside a Hermes chat? Use /model claude-sonnet-4-6 --provider anthropic --global to hot-swap the running session and persist the change at the same time.

​
Step 3: Connect Marrow MCP via mcp-remote

Hermes reads MCP server configuration from ~/.hermes/config.yaml. Marrow MCP is a remote HTTP server, so you connect it through the mcp-remote proxy. The proxy bridges the HTTP transport into the local stdio interface that Hermes expects.
  1. Open ~/.hermes/config.yaml in a text editor.
  2. Add or extend the mcp_servers section with the following block:
Replace YOUR_MARROW_MCP_KEY with your key from Marrow MCP Integrations.
  1. Save the file and restart Hermes (quit and reopen the desktop app).

​
Quick setup reference

If you are already familiar with Hermes, use this setup reference:

​
Step 4: Verify the MCP connection

  1. Restart Hermes and open a new chat.
  2. Type the following message:
Hermes should respond with a list of Marrow MCP tools, such as list_sellers, query_table, and others. If no tools appear, check that Node.js is installed and that the mcp_servers block in config.yaml is correctly indented.

​
Step 5: First conversation with Amazon data

CLI or UI: your choice. You can chat with Hermes from the terminal (hermes chat) or from the Hermes desktop UI. Both interfaces share the same config.yaml and MCP setup. The examples from this step onwards use the Hermes desktop UI client.
Run a simple test query to confirm that live Amazon data flows through Marrow:
Hermes calls the list_sellers Marrow tool and returns the names of your connected accounts. If you see your sellers listed, the connection is working. Hermes chat - first Amazon data query result

​
Step 6: Generate a 7-day sales report for Delto UK

Now use Hermes to produce a business report. Open a new chat and paste the prompt below. Hermes will call Marrow tools, retrieve the data, analyse it, and write a structured markdown report.
Hermes chat - 7-day sales report result Hermes will:
  1. Call list_sellers to confirm the Delto UK account.
  2. Query the Profit by SKU & Date table for the last 7 days.
  3. Analyse the data and produce a structured markdown report with per-SKU breakdowns, daily rows, and executive KPIs.

​
Marrow MCP resources

Check the following resources for more information: