Gorgias MCP server

Connect Gorgias to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Gorgias MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the create ticket tool in Gorgias
  • Use the update ticket tool in Gorgias
  • Use the list satisfaction surveys tool in Gorgias
  • Use the create message tool in Gorgias
  • Use the manage ticket tags tool in Gorgias
  • Use the create customer tool in Gorgias

Supported Tools

create_ticket

Create Ticket

Create a new support ticket with an initial message. Supports API, email, chat, phone, and SMS channels. A ticket always requires at least one message.

update_ticket

Update Ticket

Update an existing support ticket. Can change status, priority, assignee, tags, subject, custom fields, and more. Only provide the fields you want to change.

list_satisfaction_surveys

List Satisfaction Surveys

Retrieve a paginated list of customer satisfaction surveys (CSAT). Surveys capture customer feedback after support interactions.

create_message

Create Message

Add a new message to an existing ticket. Can create customer replies, agent responses, or internal notes. Supports HTML and plain text content.

manage_ticket_tags

Manage Ticket Tags

Add, remove, or replace tags on a ticket. Use "add" to append tags, "remove" to remove specific tags, or "set" to replace all tags on the ticket.

create_customer

Create Customer

Create a new customer record in Gorgias with contact channels, name, and metadata.

get_user

Get User

Retrieve details of a specific helpdesk agent user. Use user ID 0 to get the currently authenticated user.

get_account

Get Account

Retrieve account-level information and settings for the Gorgias helpdesk, including domain, plan, and business configuration.

delete_macro

Delete Macro

Permanently delete a macro template.

update_tag

Update Tag

Update an existing tag's name or color.

delete_rule

Delete Rule

Permanently delete an automation rule.

list_rules

List Rules

Retrieve a paginated list of automation rules. Rules trigger actions based on ticket events and conditions.

list_tickets

List Tickets

Retrieve a paginated list of support tickets. Can filter by status, assignee, or customer. Use cursor-based pagination to iterate through results.

create_macro

Create Macro

Create a new macro template with a name and a set of actions that will be executed when the macro is applied.

update_customer

Update Customer

Update an existing customer's profile, contact channels, or metadata. Only provide the fields you want to change.

delete_tag

Delete Tag

Permanently delete a tag. Tickets currently using this tag will have it removed.

create_tag

Create Tag

Create a new tag for categorizing tickets. Optionally specify a color for visual identification.

list_tags

List Tags

Retrieve all tags available in the helpdesk. Tags are used to categorize and organize tickets.

list_macros

List Macros

Retrieve a paginated list of macro templates. Macros are reusable response templates with configurable actions.

create_rule

Create Rule

Create a new automation rule with events, conditions, and actions. Rules automate ticket handling based on configurable triggers.

get_customer

Get Customer

Retrieve full details of a customer, including their contact channels, metadata, and associated data.

update_rule

Update Rule

Update an existing automation rule. Can change name, conditions, actions, priority, or enable/disable the rule.

list_users

List Users

Retrieve a paginated list of helpdesk agent users. Includes agent names, emails, roles, and team assignments.

list_messages

List Messages

Retrieve all messages for a given ticket, ordered by sending date. Includes customer replies, agent responses, and internal notes.

delete_ticket

Delete Ticket

Permanently delete a support ticket and all its messages. This action cannot be undone.

list_customers

List Customers

Retrieve a paginated list of customers. Can filter by email address.

get_ticket

Get Ticket

Retrieve full details of a single support ticket, including messages, customer info, tags, assignee, and satisfaction survey data.

update_macro

Update Macro

Update an existing macro's name or actions.

merge_customers

Merge Customers

Merge multiple customer records into one. The main customer retains its data, and secondary customers' data is merged into it. Secondary customer records are deleted after merging.

get_current_user

Get Current User

Retrieve the authenticated helpdesk agent and verify the connected account identity.

list_views

List Views

List ticket views and discover view IDs to filter list_tickets using saved queue filters.

list_teams

List Teams

List helpdesk teams and discover team IDs for assigning tickets.

Connect Gorgias to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Gorgias in Metorial. In your Metorial portal, enable the Gorgias MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Gorgias tools.

Run Gorgias through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Gorgias and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Gorgias tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Gorgias

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Apolloio

Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.

Hubspot

Create, read, update, and delete CRM objects including contacts, companies, deals, tickets, and custom objects. Manage associations between CRM records. Track engagements such as calls, emails, meetings, notes, and tasks. Send transactional and marketing emails, manage campaigns, and handle subscription preferences. Build and manage marketing workflows, sequences, and automation actions. Manage CMS content including blog posts, landing pages, and HubDB tables. Handle commerce data including products, orders, invoices, quotes, and payments. Create and manage contact lists for segmentation. Configure deal, ticket, and order pipelines with custom stages. Search and filter CRM records. Bulk import and export CRM data. Manage users, teams, and account settings.

Linkedin

Authenticate LinkedIn members with OpenID Connect, fetch the authenticated member profile, and create self-serve LinkedIn shares with text, article links, and uploaded images. Organization and Community Management workflows should move to a separate slate because LinkedIn restricts combining those products in one app.

Calendly

List, retrieve, and cancel scheduled events. Book meetings programmatically on behalf of invitees using available time slots. Retrieve event types and their configurations. Query user availability, available time slots, busy times, and availability schedules. Create single-use scheduling links with optional overrides. List and manage invitees, mark no-shows, and access custom question responses and UTM tracking data. Manage organization memberships, invite or remove users. Retrieve routing form configurations and submissions. Subscribe to webhooks for new bookings, cancellations, and routing form submissions.

Mailchimp

Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.

Technical notes for Gorgias

Manage support tickets, customer profiles, ticket tags, reusable macros, and automation rules in Gorgias. Create customer and agent messages, add internal notes and file URLs, merge customer records, and list satisfaction surveys. Discover the current user, helpdesk teams, and saved ticket views for assignment and queue filtering.

Frequently asked questions

Common questions about connecting Gorgias to AI agents with Metorial.

  1. How many tools does the Gorgias MCP server have?
    The Gorgias MCP server exposes 33 tools, including Create Ticket, Update Ticket, List Satisfaction Surveys. Each one is governed and traced through Metorial.
  2. Gorgias exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Gorgias MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Gorgias and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Gorgias MCP server yourself or use the hosted gateway.

Connect Gorgias to production AI agents

See how Metorial gives your team governed access to Gorgias, with tracing and security controls built in.