Can I use Gorgias as a CLI?

Yes. KosmoKrator exposes a Gorgias CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Gorgias through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Gorgias tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Gorgias credentials stored?

Gorgias credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Gorgias MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Gorgias CLI for Headless Automation

Use the Gorgias CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

7 functions 6 read 1 write Bearer token auth

Submit Gorgias feedback View package source

Gorgias CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The Gorgias CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Gorgias CLI for Headless Automation
kosmokrator integrations:configure gorgias --set access_token="$GORGIAS_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call gorgias.gorgias_list_tickets '{"page":1,"limit":1,"status":"example_status","q":"example_q"}' --json

Discovery Before Execution

Agents and scripts can inspect Gorgias docs and schemas before choosing a function.

kosmo integrations:docs gorgias --json
kosmo integrations:docs gorgias.gorgias_list_tickets --json
kosmo integrations:schema gorgias.gorgias_list_tickets --json
kosmo integrations:search "Gorgias" --json
kosmo integrations:list --json

Useful Gorgias CLI Functions

Function	Type	Parameters	Description
`gorgias.gorgias_list_tickets`	Read	page, limit, status, q	List and search support tickets in Gorgias. Filter by status or search by keyword. Returns paginated results with ticket IDs, subjects, and metadata.
`gorgias.gorgias_get_ticket`	Read	id	Get details of a specific Gorgias ticket by ID, including subject, body, status, assignee, and customer information.
`gorgias.gorgias_create_ticket`	Write	subject, body, from_email, to_email, channel, priority	Create a new support ticket in Gorgias with a subject and body. Optionally specify sender, recipient, channel, and priority.
`gorgias.gorgias_list_customers`	Read	page, limit, q	List and search customers in Gorgias. Filter by search query covering name, email, and other fields. Returns paginated results.
`gorgias.gorgias_get_customer`	Read	id	Get details of a specific Gorgias customer by ID, including name, email, and custom fields.
`gorgias.gorgias_list_satisfaction_surveys`	Read	page, limit, ticket_id	List satisfaction survey responses in Gorgias. Optionally filter by ticket ID. Returns paginated results with ratings and feedback.
`gorgias.gorgias_get_current_user`	Read	none	Get the profile of the currently authenticated Gorgias user. Returns name, email, and account details.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Gorgias CLI Pages

CI Gorgias CLI for CI. Cron Jobs Gorgias CLI for cron jobs. Shell Scripts Gorgias CLI for shell scripts. Coding Agents Gorgias CLI for coding agents.