Skip to content

Connect Hermes Agent to Supabase

Connect Hermes Agent to Supabase: 1. Sign in to ApexGenius and connect Supabase. 2. Add the ApexGenius MCP server. 3. Start using Supabase in Hermes Agent.

1,000 free credits · No card required

How to connect Supabase to Hermes Agent

  1. 1Sign in to ApexGenius and connect Supabase
  2. 2Add the ApexGenius MCP server to Hermes Agent
  3. 3Start using Supabase in Hermes Agent
  1. 1ApexGenius

    Connect Supabase to ApexGenius

    Open Supabase in ApexGenius

    Open Supabase in Connections and choose Connect.

  2. 2ApexGenius

    Connect ApexGenius to Hermes Agent

    Copy the MCP address

    On Start, pick API key, open Manual setup, and copy the MCP address.

  3. 3ApexGenius

     

    Approve access

    ApexGenius opens its approval page. Review the access, then approve.

Add the ApexGenius MCP server to Hermes Agent

Hermes Agent reads MCP servers from ~/.hermes/config.yaml, under mcp_servers.

  1. Add the apexgenius entry under mcp_servers and save the file.
  2. In a new terminal, run hermes mcp login apexgenius. Hermes prints an authorize URL and opens your browser when it can.
  3. Sign in to ApexGenius and approve access.
  4. Start Hermes with hermes chat, or run /reload-mcp in a session that is already open.
Add to ~/.hermes/config.yaml
mcp_servers:
  apexgenius:
    url: "https://server.autom8.pro/mcp"
    auth: oauth

Check it. Run hermes mcp test apexgenius. It connects, lists the tools it found and exits 0 when the connection completes.

Steps follow Hermes Agent documentation, MCP (Model Context Protocol) (opens in a new tab), read November 12, 2026.

Then ask Hermes Agent

List the tables in my Supabase project. Do not run SQL or change anything.

Start free
Written setup, step by stepShow

Before you start

  • An account with permission to use the Supabase resources you intend to connect.

1. Connect Supabase to ApexGenius

  1. Open Supabase in Connections. Choose Connect, or Add connection when offered. Give the connection a name if prompted. If Gateway setup pending appears, contact ApexGenius support before continuing.
    The Supabase page in ApexGenius before you connect, with the Connect button in the header and the Not connected empty state.
    The Supabase page before you connect. Choose Connect to open Supabase's own sign-in.Open full-size image (opens in a new tab)
  2. Choose the account and review access. Sign in on Supabase’s page, choose the organization that owns your project, and approve the access ApexGenius asks for. Supabase uses browser authorization; no API key or database password.
  3. Review the connected account and resources. On the connection page Overview, turn on the one project your AI may use. Turning one on turns the others off, and with none on, Supabase tools do nothing. Enabled writes run when called: SQL and migrations can change or delete data.
  4. Check the connection. Use Test connection or Check again and read the reported status. Add an AI agent from the AI agents page, choose Read only for the first test, and try the question below.
Connect Supabase →

2. Connect ApexGenius to Hermes Agent

Use this server address when adding the connection:

https://server.autom8.pro/mcp

The steps are above, under Add the ApexGenius MCP server to Hermes Agent. These notes apply to Hermes Agent only.

  • On a server with no browser. Hermes prints “Or paste the redirect URL here” beside the authorize URL. Open the URL on your own machine, approve, and paste the full URL the browser lands on. That page shows a connection error, which is expected.
  • Use a new terminal for the sign-in. Editing config.yaml inside a running session reloads MCP with a 30 second limit, too short for a browser sign-in. hermes mcp login waits five minutes.
  • Where the sign-in is kept. Hermes caches the tokens at ~/.hermes/mcp-tokens/apexgenius.json and reuses them until a refresh fails. Run hermes mcp login apexgenius again if that happens.
  • Tool names. Hermes prefixes each MCP tool with the server name, so the ApexGenius tools carry apexgenius in their names.
  • Access. When ApexGenius asks what Hermes Agent may use, choose Read only for the first test, or Custom to limit it to the tools you need.

3. Verify one safe read

List the tables in my Supabase project. Do not run SQL or change anything.

List the tables in my Supabase project. Do not run SQL or change anything.

Compare the returned account and resource with Supabase. Check the connection status separately from the result of the first read.

Full guide: the Supabase setup guide.

What it looks like in Hermes Agent

Illustration of a task, not a recorded customer result. Your answers come from the account and dates you choose.

How the route works
Hermes Agent
Hermes AgentApexGenius MCP route
Run the Supabase security advisor on my project and list every table that has row level security turned off.
ApexGenius
Working with ApexGenius3 reads
RequestConnected read
Account scopeAuthorized connections checked
Salesforceapex_call_read_toolsalesforce_read · Find matching recordsComplete
Salesforceapex_call_read_toolsalesforce_read · Read related activityComplete
n8napex_call_read_tooln8n_get_workflow · Check workflow statusComplete
Hermes Agent

Three safe example reads returned results. Nothing was changed.

Read-only route
Hermes Agent

Try asking

Run the Supabase security advisor on my project and list every table that has row level security turned off.

Show the last hour of API errors in my Supabase logs, grouped by path.

Generate TypeScript types for the public schema of my Supabase project.

Write a migration that adds a created_at column with a default of now() to the orders table, show it to me, then apply it.

What Hermes Agent can do in Supabase

20 operations: 12 read, 8 write. Read looks things up and changes nothing. Writes change Supabase and run only when you turn them on.

Database

3 read · 2 write
  • list_tablesread
  • list_extensionsread
  • list_migrationsread
  • execute_sqlwrite
  • apply_migrationwrite

Logs and advisors

2 read
  • query_logsread
  • get_advisorsread

Project details

3 read
  • get_project_urlread
  • get_publishable_keysread
  • generate_typescript_typesread

Edge Functions

2 read · 1 write
  • list_edge_functionsread
  • get_edge_functionread
  • deploy_edge_functionwrite

Branches

1 read · 5 write
  • list_branchesread
  • create_branchwrite
  • rebase_branchwrite
  • merge_branchwrite
  • reset_branchwrite
  • delete_branchwrite

Docs

1 read
  • search_docsread

You choose the access. When you approve Hermes Agent, pick Full access, Read only, or Custom.

Supabase uses browser authorization: you pick the organization on Supabase's page and approve. No API key, access token or database password is pasted into ApexGenius.

A connection reaches one project, the one you turn on. Turning one on turns the others off, and with none on, Supabase tools do nothing. Tools that list, create or pause projects are not exposed.

Writes run when called unless you set a tool to Ask me first. execute_sql, apply_migration, merge_branch, reset_branch and delete_branch can change or delete data with no undo, and create_branch is billed by the hour.

Start free

Questions about connecting Hermes Agent to Supabase

Updated November 12, 2026.

How do I connect Hermes Agent to Supabase?

Sign in to ApexGenius and connect Supabase. In Hermes Agent, add an apexgenius entry with the ApexGenius MCP address and auth: oauth under mcp_servers in ~/.hermes/config.yaml, then run hermes mcp login apexgenius. Then ask Hermes Agent: “List the tables in my Supabase project. Do not run SQL or change anything.” Start with a read, so nothing changes.

How do I check that Hermes Agent can use Supabase?

Run hermes mcp test apexgenius. It connects, lists the tools it found and exits 0 when the connection completes. In a session that is already open, /reload-mcp picks up a config change. If the sign-in has expired, run hermes mcp login apexgenius again. Then ask: “List the tables in my Supabase project. Do not run SQL or change anything.”

What do I need to connect Supabase?

A Supabase account that can open the project. Choose Connect, sign in on Supabase, pick the organization and approve. Then turn on the one project your AI may use.

Can my AI reach every project in my organization?

No. A connection reaches only the project you turn on, and nothing while none is on. To work in another project, turn that one on instead.

Can my AI change or delete data?

Yes, when the tool is enabled. execute_sql and apply_migration can change or delete rows and tables, and there is no undo. Set those tools to Ask me first, or give a Read only key to agents that should only look.

Does this use Supabase hosted MCP?

Yes. ApexGenius connects to Supabase's official hosted MCP server at mcp.supabase.com with Supabase's own sign-in. ApexGenius never sees your database password.

What should I test first?

Ask your AI to list the tables in your project. It is a read and changes nothing.

Connect Supabase to Hermes Agent today

Start free

1,000 free credits. No card required. Disconnect any time.