Can I use Freshdesk as a CLI?

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

Can I expose Freshdesk through MCP?

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

Where are Freshdesk credentials stored?

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

Can I deny write access for Freshdesk MCP tools?

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

productivity

Freshdesk MCP, CLI, and Lua Integration for AI Agents

Freshdesk integration docs for AI agents: MCP gateway setup, Freshdesk CLI commands, Lua API reference, credentials, and function schemas.

15 functions 9 read 6 write API key auth

Submit Freshdesk feedback View package source

Freshdesk for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: freshdesk
route_slug: freshdesk
package: freshdesk
auth_strategy: api_key API key
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Freshdesk CLIHeadless setup and direct function calls. Freshdesk MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Freshdesk MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Freshdesk.

Freshdesk CLI Matrix

Use these pages for direct Freshdesk CLI workflows in scripts, CI, cron, and agent wrappers.

CI Freshdesk CLI for CI. Cron Jobs Freshdesk CLI for cron jobs. Shell Scripts Freshdesk CLI for shell scripts. Headless Automation Freshdesk CLI for headless automation. Coding Agents Freshdesk CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`freshdesk.freshdesk_list_tickets`	Read `read`	6	List support tickets from Freshdesk. Supports filtering by status, priority, and pagination. Returns ticket details including subject, status, priority, requester, and assignee.
`freshdesk.freshdesk_get_ticket`	Read `read`	1	Get full details of a specific support ticket including description, custom fields, conversation history, and associated contacts.
`freshdesk.freshdesk_create_ticket`	Write `write`	10	Create a new support ticket. Requires a subject, description, and requester email. Optionally set priority and status.
`freshdesk.freshdesk_update_ticket`	Write `write`	9	Update an existing support ticket. Can change subject, description, status, priority, assignee, and other fields.
`freshdesk.freshdesk_delete_ticket`	Write `write`	1	Permanently delete a support ticket. This action cannot be undone.
`freshdesk.freshdesk_list_contacts`	Read `read`	6	List customer contacts from Freshdesk. Supports pagination. Returns contact names, emails, and company associations.
`freshdesk.freshdesk_get_contact`	Read `read`	1	Get full details of a specific customer contact including email, phone, company, and custom fields.
`freshdesk.freshdesk_create_contact`	Write `write`	7	Create a new customer contact in Freshdesk. Requires an email address and name.
`freshdesk.freshdesk_list_agents`	Read `read`	2	List all helpdesk agents. Returns agent details including name, email, availability, and group memberships.
`freshdesk.freshdesk_get_agent`	Read `read`	1	Get details of a specific helpdesk agent including name, email, role, availability, and group assignments.
`freshdesk.freshdesk_list_conversations`	Read `read`	1	List all conversations on a ticket — includes public replies and private notes. Shows who posted, the body, and timestamps.
`freshdesk.freshdesk_create_reply`	Write `write`	4	Post a public reply to a support ticket. The reply is visible to the requester. Use this to respond to customers.
`freshdesk.freshdesk_create_note`	Write `write`	2	Add a private note to a support ticket. Notes are only visible to agents, not to the customer. Use for internal communication.
`freshdesk.freshdesk_list_companies`	Read `read`	2	List customer companies from Freshdesk. Supports pagination. Returns company names, domains, and associated contacts.
`freshdesk.freshdesk_get_current_user`	Read `read`	0	Get the currently authenticated Freshdesk agent. Returns agent name, email, role, and availability. Use this to verify API credentials are working.