Gorgias MCP server
114 operations0 webhooks
Access the Gorgias REST API for customer support accounts, including tickets, customers, messages, users, configuration, reporting, and file operations.
Try Gorgias with your agent
Connect Gorgias, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Gorgias on my account, then run one read-only example and show me the result.
Gorgias tools and triggers
Tools are what your agent can do in Gorgias through Corsair's MCP server. Triggers are the Gorgias events a routine can start from.
Tickets
- Create TicketDestructive
Gorgias REST: Create a ticket. Messages without sent_datetime are sent to the customer by Gorgias.
tickets.createTicket
- Create Ticket TagsWrite
Gorgias REST: Add ticket tags.
tickets.createTicketTags
- Delete TicketDestructive
Gorgias REST: Delete a ticket.
tickets.deleteTicket
- Delete Ticket Custom FieldDestructive
Gorgias REST: Delete ticket field value.
tickets.deleteTicketCustomField
- Delete Ticket TagsDestructive
Gorgias REST: Remove ticket tags.
tickets.deleteTicketTags
- Get TicketRead-only
Gorgias REST: Retrieve a ticket.
tickets.getTicket
- List Ticket Custom FieldsRead-only
Gorgias REST: List ticket field values.
tickets.listTicketCustomFields
- List Ticket TagsRead-only
Gorgias REST: List ticket tags.
tickets.listTicketTags
- List TicketsRead-only
Gorgias REST: List tickets.
tickets.listTickets
- Update TicketWrite
Gorgias REST: Update a ticket.
tickets.updateTicket
- Update Ticket Custom FieldWrite
Gorgias REST: Update ticket field value.
tickets.updateTicketCustomField
- Update Ticket Custom FieldsDestructive
Gorgias REST: Replace all custom field values on a ticket. Fields left out of the request are deleted.
tickets.updateTicketCustomFields
- Update Ticket TagsDestructive
Gorgias REST: Replace all tags on a ticket with the given list.
tickets.updateTicketTags
Customers
- Create CustomerWrite
Gorgias REST: Create a customer.
customers.createCustomer
- Delete CustomerDestructive
Gorgias REST: Delete a customer.
customers.deleteCustomer
- Delete Customer Custom Field ValueDestructive
Gorgias REST: Delete customer field value.
customers.deleteCustomerCustomFieldValue
- Delete CustomersDestructive
Gorgias REST: Delete customers.
customers.deleteCustomers
- Get CustomerRead-only
Gorgias REST: Retrieve a customer.
customers.getCustomer
- List Customer Custom Fields ValuesRead-only
Gorgias REST: List customer field values.
customers.listCustomerCustomFieldsValues
- List CustomersRead-only
Gorgias REST: List customers.
customers.listCustomers
- Merge CustomersDestructive
Gorgias REST: Merge two customers.
customers.mergeCustomers
- Update CustomerWrite
Gorgias REST: Update a customer.
customers.updateCustomer
- Update Customer Custom Field ValueWrite
Gorgias REST: Update customer field value.
customers.updateCustomerCustomFieldValue
- Update Customer Custom Field ValuesWrite
Gorgias REST: Update customer fields values.
customers.updateCustomerCustomFieldValues
- Update Customer DataDestructive
Gorgias REST: Replace a customer's data object.
customers.updateCustomerData
Macros
- Bulk Archive MacrosDestructive
Gorgias REST: Archive macros.
macros.bulkArchiveMacros
- Bulk Unarchive MacrosDestructive
Gorgias REST: Unarchive macros.
macros.bulkUnarchiveMacros
- Create MacroWrite
Gorgias REST: Create a macro.
macros.createMacro
- Delete MacroDestructive
Gorgias REST: Delete a macro.
macros.deleteMacro
- Get MacroRead-only
Gorgias REST: Retrieve a macro.
macros.getMacro
- List MacrosRead-only
Gorgias REST: List macros.
macros.listMacros
- Update MacroWrite
Gorgias REST: Update a macro.
macros.updateMacro
Tags
- Create TagWrite
Gorgias REST: Create a tag.
tags.createTag
- Delete TagDestructive
Gorgias REST: Delete a tag.
tags.deleteTag
- Delete TagsDestructive
Gorgias REST: Delete tags.
tags.deleteTags
- Get TagRead-only
Gorgias REST: Retrieve a tag.
tags.getTag
- List TagsRead-only
Gorgias REST: List tags.
tags.listTags
- Merge TagsDestructive
Gorgias REST: Merge tags.
tags.mergeTags
- Update TagWrite
Gorgias REST: Update a tag.
tags.updateTag
Views
- Create ViewWrite
Gorgias REST: Create a view.
views.createView
- Delete ViewDestructive
Gorgias REST: Delete a view.
views.deleteView
- Get ViewRead-only
Gorgias REST: Retrieve a view.
views.getView
- List View ItemsRead-only
Gorgias REST: List view's items.
views.listViewItems
- List ViewsRead-only
Gorgias REST: List views.
views.listViews
- Update ViewWrite
Gorgias REST: Update a view.
views.updateView
- Update View ItemsWrite
Gorgias REST: Search for view's items.
views.updateViewItems
Rules
- Create RuleWrite
Gorgias REST: Create a rule.
rules.createRule
- Delete RuleDestructive
Gorgias REST: Delete a rule.
rules.deleteRule
- Get RuleRead-only
Gorgias REST: Retrieve a rule.
rules.getRule
- List RulesRead-only
Gorgias REST: List rules.
rules.listRules
- Update RuleWrite
Gorgias REST: Update a rule.
rules.updateRule
- Update Rules PrioritiesWrite
Gorgias REST: Update rules' priorities.
rules.updateRulesPriorities
Ticket Messages
- Create Ticket MessageDestructive
Gorgias REST: Create a message.
ticketMessages.createTicketMessage
- Delete Ticket MessageDestructive
Gorgias REST: Delete a message.
ticketMessages.deleteTicketMessage
- Get Ticket MessageRead-only
Gorgias REST: Retrieve a message.
ticketMessages.getTicketMessage
- List MessagesRead-only
Gorgias REST: List messages.
ticketMessages.listMessages
- List Ticket MessagesRead-only
Gorgias REST: List messages of a ticket.
ticketMessages.listTicketMessages
- Update Ticket MessageWrite
Gorgias REST: Update a message.
ticketMessages.updateTicketMessage
Custom Fields
- Create Custom FieldWrite
Gorgias REST: Create a custom field.
customFields.createCustomField
- Get Custom FieldRead-only
Gorgias REST: Retrieve a custom field.
customFields.getCustomField
- List Custom FieldsRead-only
Gorgias REST: List custom fields.
customFields.listCustomFields
- Update Custom FieldWrite
Gorgias REST: Update a custom field.
customFields.updateCustomField
- Update Custom FieldsWrite
Gorgias REST: Bulk update a list of custom fields.
customFields.updateCustomFields
Integrations
- Create IntegrationWrite
Gorgias REST: Create an integration.
integrations.createIntegration
- Delete IntegrationDestructive
Gorgias REST: Delete an integration.
integrations.deleteIntegration
- Get IntegrationRead-only
Gorgias REST: Retrieve an integration.
integrations.getIntegration
- List IntegrationsRead-only
Gorgias REST: List integrations.
integrations.listIntegrations
- Update IntegrationWrite
Gorgias REST: Update an integration.
integrations.updateIntegration
Teams
- Create TeamWrite
Gorgias REST: Create a team.
teams.createTeam
- Delete TeamDestructive
Gorgias REST: Delete a team.
teams.deleteTeam
- Get TeamRead-only
Gorgias REST: Retrieve a team.
teams.getTeam
- List TeamsRead-only
Gorgias REST: List teams.
teams.listTeams
- Update TeamWrite
Gorgias REST: Update a team.
teams.updateTeam
Users
- Create UserWrite
Gorgias REST: Create a user.
users.createUser
- Delete UserDestructive
Gorgias REST: Delete a user.
users.deleteUser
- Get UserRead-only
Gorgias REST: Retrieve a user.
users.getUser
- List UsersRead-only
Gorgias REST: List users.
users.listUsers
- Update UserWrite
Gorgias REST: Update a user.
users.updateUser
Widgets
- Create WidgetWrite
Gorgias REST: Create a widget.
widgets.createWidget
- Delete WidgetDestructive
Gorgias REST: Delete a widget.
widgets.deleteWidget
- Get WidgetRead-only
Gorgias REST: Retrieve a widget.
widgets.getWidget
- List WidgetsRead-only
Gorgias REST: List widgets.
widgets.listWidgets
- Update WidgetWrite
Gorgias REST: Update a widget.
widgets.updateWidget
Account
- Create Account SettingWrite
Gorgias REST: Create a setting.
account.createAccountSetting
- Get AccountRead-only
Gorgias REST: Retrieve your account.
account.getAccount
- List Account SettingsRead-only
Gorgias REST: List settings.
account.listAccountSettings
- Update Account SettingWrite
Gorgias REST: Update a setting.
account.updateAccountSetting
Satisfaction Surveys
- Create Satisfaction SurveyDestructive
Gorgias REST: Create a survey.
satisfactionSurveys.createSatisfactionSurvey
- Get Satisfaction SurveyRead-only
Gorgias REST: Retrieve a survey.
satisfactionSurveys.getSatisfactionSurvey
- List Satisfaction SurveysRead-only
Gorgias REST: List surveys.
satisfactionSurveys.listSatisfactionSurveys
- Update Satisfaction SurveyWrite
Gorgias REST: Update a survey.
satisfactionSurveys.updateSatisfactionSurvey
Metric Cards
- Create Metric Card FeedbackWrite
Gorgias REST: Submit feedback on a metric card definition.
metricCards.createMetricCardFeedback
- Get Metric CardRead-only
Gorgias REST: Retrieve a metric card by slug.
metricCards.getMetricCard
- Search Metric CardsRead-only
Gorgias REST: Search metric cards.
metricCards.searchMetricCards
Voice Call Recordings
- Delete Voice Call RecordingDestructive
Gorgias REST: Delete a voice call recording.
voiceCallRecordings.deleteVoiceCallRecording
- Get Voice Call RecordingRead-only
Gorgias REST: Retrieve a voice call recording.
voiceCallRecordings.getVoiceCallRecording
- List Voice Call RecordingsRead-only
Gorgias REST: List voice call recordings.
voiceCallRecordings.listVoiceCallRecordings
Events
- Get EventRead-only
Gorgias REST: Retrieve an event.
events.getEvent
- List EventsRead-only
Gorgias REST: List events.
events.listEvents
Files
- Download FileRead-only
Gorgias REST: Download a file.
files.downloadFile
- Upload FilesWrite
Gorgias REST: Upload files.
files.uploadFiles
Statistics
- Download Legacy StatisticRead-only
Gorgias REST: Download a statistic.
statistics.downloadLegacyStatistic
- Get Legacy StatisticRead-only
Gorgias REST: Retrieve a statistic.
statistics.getLegacyStatistic
Voice Call Events
- Get Voice Call EventRead-only
Gorgias REST: Retrieve a voice call event.
voiceCallEvents.getVoiceCallEvent
- List Voice Call EventsRead-only
Gorgias REST: List voice call events.
voiceCallEvents.listVoiceCallEvents
Voice Calls
- Get Voice CallRead-only
Gorgias REST: Retrieve a voice call.
voiceCalls.getVoiceCall
- List Voice CallsRead-only
Gorgias REST: List voice calls.
voiceCalls.listVoiceCalls
Reporting Statistics
- Get StatisticRead-only
Gorgias REST: Retrieve a statistic.
reportingStatistics.getStatistic
Search
- SearchRead-only
Gorgias REST: Search for resources.
search.search
Jobs
- Cancel JobDestructive
Gorgias REST: Cancel a job.
jobs.cancelJob
- Create JobDestructive
Gorgias REST: Create a background job (apply a macro, delete or update tickets, export).
jobs.createJob
- Get JobRead-only
Gorgias REST: Retrieve a job.
jobs.getJob
- List JobsRead-only
Gorgias REST: List jobs.
jobs.listJobs
- Update JobWrite
Gorgias REST: Update a job.
jobs.updateJob
Connect Gorgias to Claude, ChatGPT or Cursor
- 1
Connect Gorgias in Corsair
Add your Gorgias API key once in Corsair. Corsair stores the credential encrypted and makes the Gorgias API calls for your agent, so it never goes into a prompt or a config file. Connect Gorgias
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Gorgias. On a ChatGPT personal plan, connect Gorgias here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Gorgias's read and write operations run right away and its 29 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/gorgias, add the Gorgias plugin, and connect with an API key. Then call methods like corsair.gorgias.api.account.createAccountSetting() from your app. Corsair keeps each tenant isolated.
Yes. Gorgias requires an API key from your Gorgias account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Gorgias, GitHub, Notion, Stripe, and the rest. Trigger Gorgias from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for access the Gorgias REST API for customer support accounts, including tickets, customers, messages, users, configuration, reporting, and file operations. Common builds include sync jobs, admin tooling, and agents that call Gorgias APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Gorgias API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/gorgias in the open repo. When Gorgias ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Gorgias data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Gorgias data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Gorgias on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 29 destructive Gorgias operations. You can change a link's mode at hub.corsair.dev/me.