How to integrate Gorgias MCP with Hermes

GET STARTED FOR FREE
Gorgias logo
Hermes logo
divider

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Gorgias account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Gorgias with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,000+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Gorgias with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Gorgias

Ask your agent to connect to Gorgias, or simply request any Gorgias-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Gorgias connection.

Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Gorgias or request any Gorgias-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Gorgias MCP server, and what's possible with it?

The Gorgias MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Gorgias account. It provides structured and secure access to your helpdesk workspace, so your agent can perform actions like managing tickets, creating customers, tagging conversations, and organizing support teams on your behalf.

  • Automated ticket management: Instantly create, update, or delete support tickets to streamline customer interactions and resolve issues faster.
  • Customer profile control: Add new customers, update their details, or remove outdated accounts directly from your helpdesk—no manual entry required.
  • Tagging and ticket organization: Effortlessly assign or remove tags on tickets so your support requests stay organized by priority, topic, or workflow.
  • Team management: Create or delete support teams, letting your agent help restructure teams as your business grows or shifts focus.
  • Bulk customer actions: Perform batch operations like deleting multiple customers or specific field values, making mass updates and data hygiene a breeze.

Supported Tools & Triggers

Tools
Add Ticket TagsAdds tags to a ticket in gorgias.
Create Account SettingCreates a new account setting in gorgias.
Create CustomerCreates a new customer in gorgias.
Create TeamCreates a new team in gorgias.
Create TicketCreates a new ticket in gorgias.
Delete CustomerDeletes a specific customer from gorgias.
Delete Customer Field ValueDeletes a specific field value for a customer in gorgias.
Delete CustomersDeletes multiple customers from gorgias.
Delete TeamDeletes a specific team from gorgias.
Delete TicketDeletes a specific ticket from gorgias.
Delete Ticket Field ValueDeletes a specific field value for a ticket in gorgias.
Get AccountRetrieves your gorgias account information.
Get CustomerRetrieves a specific customer from gorgias.
Get EventRetrieves a specific event from gorgias.
Get TeamRetrieves a specific team from gorgias.
Get TicketRetrieves a specific ticket from gorgias.
List Account SettingsLists all account settings in gorgias.
List Customer Field ValuesLists all field values for a customer in gorgias.
List CustomersLists customers in gorgias with various filtering options.
List EventsLists events in gorgias with various filtering options.
List TeamsLists teams in gorgias.
List Ticket Field ValuesLists all field values for a ticket in gorgias.
List TicketsLists tickets in gorgias with various filtering options.
List Ticket TagsLists all tags for a ticket in gorgias.
Merge CustomersMerges two customers in gorgias, combining their data and history.
Remove Ticket TagsRemoves tags from a ticket in gorgias.
Set Customer DataSets the complete data object for a customer in gorgias.
Set Ticket TagsSets the complete list of tags for a ticket in gorgias.
Update Account SettingUpdates an existing account setting in gorgias.
Update CustomerUpdates an existing customer in gorgias.
Update TeamUpdates an existing team in gorgias.
Update TicketUpdates an existing ticket in gorgias.

Way Forward

With Gorgias connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

How to build Gorgias MCP Agent with another framework

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Gorgias MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Gorgias MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use Gorgias MCP with Claude Code

Codex logo

Codex

Use Gorgias MCP with Codex

OpenClaw logo

OpenClaw

Use Gorgias MCP with OpenClaw

CLI logo

CLI

Use Gorgias MCP with CLI

Google ADK logo

Google ADK

Use Gorgias MCP with Google ADK

LangChain logo

LangChain

Use Gorgias MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Gorgias MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Gorgias MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Gorgias MCP with LlamaIndex

CrewAI logo

CrewAI

Use Gorgias MCP with CrewAI

FAQ

What are the differences in Tool Router MCP and Gorgias MCP?

With a standalone Gorgias MCP server, the agents and LLMs can only access a fixed set of Gorgias tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Gorgias and many other apps based on the task at hand, all through a single MCP endpoint.

Can I use Tool Router MCP with Hermes?

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Gorgias tools.

Can I manage the permissions and scopes for Gorgias while using Tool Router?

Yes, absolutely. You can configure which Gorgias scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Gorgias data and credentials are handled as safely as possible.

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Book a call↗Get started for free