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.

productivity

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.

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.

Agent Surfaces

Freshteam CLIHeadless setup, JSON output, direct function calls. Freshteam MCPExpose selected tools to local MCP clients. Freshteam LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug: freshteam
route_slug: freshteam
package: freshteam
auth_strategy: bearer_token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true

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.