Can I use Freshsales as a CLI?

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

Can I expose Freshsales through MCP?

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

Where are Freshsales credentials stored?

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

Can I deny write access for Freshsales MCP tools?

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

sales

Freshsales MCP, CLI, and Lua Integration for AI Agents

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

7 functions 6 read 1 write API key auth

Submit Freshsales feedback View package source

Freshsales 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: freshsales
route_slug: freshsales
package: freshsales
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. Freshsales CLIHeadless setup and direct function calls. Freshsales 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.

Freshsales MCP Client Matrix

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

Freshsales CLI Matrix

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

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

Function Catalog

Function	Type	Parameters	Description
`freshsales.freshsales_create_contact`	Write `write`	4	Create a new contact in Freshsales CRM with name, email, and phone details.
`freshsales.freshsales_get_contact`	Read `read`	1	Get full details for a specific Freshsales contact by ID.
`freshsales.freshsales_get_current_user`	Read `read`	0	Get the profile of the currently authenticated Freshsales user. Useful for verifying the API connection.
`freshsales.freshsales_get_deal`	Read `read`	1	Get full details for a specific Freshsales deal by ID.
`freshsales.freshsales_list_accounts`	Read `read`	2	List sales accounts (companies) from Freshsales CRM. Returns paginated results.
`freshsales.freshsales_list_contacts`	Read `read`	4	List contacts from Freshsales CRM. Returns paginated results with optional sorting by field and direction.
`freshsales.freshsales_list_deals`	Read `read`	2	List deals from Freshsales CRM. Returns paginated results showing deal pipeline information.