Can I use Freshteam as a CLI?

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

Can I expose Freshteam through MCP?

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

Where are Freshteam credentials stored?

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

Can I deny write access for Freshteam MCP tools?

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

Freshteam MCP, CLI, and Lua Integration for AI Agents

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

7 functions 7 read 0 write Bearer token auth

Submit Freshteam feedback View package source

Freshteam 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: freshteam
route_slug: freshteam
package: freshteam
auth_strategy: bearer_token Bearer token
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. Freshteam CLIHeadless setup and direct function calls. Freshteam 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.

Freshteam MCP Client Matrix

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

Freshteam CLI Matrix

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

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

Function Catalog

Function	Type	Parameters	Description
`freshteam.freshteam_list_candidates`	Read `read`	3	List recruitment candidates from Freshteam. Returns paginated candidate records with optional filtering by status.
`freshteam.freshteam_get_candidate`	Read `read`	1	Retrieve detailed information about a specific candidate in Freshteam by their ID.
`freshteam.freshteam_list_job_postings`	Read `read`	4	List job postings from Freshteam. Returns paginated job records with optional filtering by status and department.
`freshteam.freshteam_get_job_posting`	Read `read`	1	Retrieve detailed information about a specific job posting in Freshteam by its ID.
`freshteam.freshteam_list_employees`	Read `read`	3	List employees from Freshteam. Returns paginated employee records with optional filtering by department.
`freshteam.freshteam_get_employee`	Read `read`	1	Retrieve detailed information about a specific employee in Freshteam by their ID.
`freshteam.freshteam_get_current_user`	Read `read`	0	Retrieve the profile of the currently authenticated Freshteam user. Useful for verifying the connection and identifying which account is active.