Connecting Hermes MCP to Codex CLI

Hermes is exposed for Codex at:

https://hermes.squaremcp.com/mcp

Recommended setup

Add this block to your global Codex config at:

~/.codex/config.toml

[mcp_servers.hermes]
url = "https://hermes.squaremcp.com/mcp"

If the file already exists, append or merge the block instead of replacing your other config.

Example

[projects."/path/to/your/project"]
trust_level = "trusted"

[mcp_servers.hermes]
url = "https://hermes.squaremcp.com/mcp"

Auth model

Hermes supports:

x-api-key
?key=
OAuth bearer tokens

Codex config currently uses the server URL block above. If your Codex build later exposes MCP header configuration directly, use your own live credential and do not commit it into this repo.

Verify

After updating ~/.codex/config.toml, restart Codex and check that the hermes MCP server is available in the tool space for the project.

Current production endpoint

https://hermes.squaremcp.com/mcp

1.2 KiB Raw Blame History