Can I use Recruitee as a CLI?

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

Can I expose Recruitee through MCP?

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

Where are Recruitee credentials stored?

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

Can I deny write access for Recruitee MCP tools?

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

Recruitee CLI for AI Agents

Use the Recruitee CLI from KosmoKrator to call Recruitee tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

6 functions 6 read 0 write Bearer token auth

Submit Recruitee feedback View package source

Recruitee CLI Setup

Recruitee can be configured headlessly with `kosmokrator integrations:configure recruitee`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure recruitee --set access_token="$RECRUITEE_ACCESS_TOKEN" --set company_id="$RECRUITEE_COMPANY_ID" --enable --read allow --write ask --json
kosmokrator integrations:doctor recruitee --json
kosmokrator integrations:status --json

Credentials

Authentication type: Bearer token bearer_token. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`access_token`	`RECRUITEE_ACCESS_TOKEN`	Secret `secret`	yes	Access Token
`company_id`	`RECRUITEE_COMPANY_ID`	Text `text`	yes	Company ID
`url`	`RECRUITEE_URL`	URL `url`	no	API Base URL

Call Recruitee Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call recruitee.recruitee_list_offers '{
  "status": "example_status",
  "page": 1,
  "limit": 1
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:recruitee recruitee_list_offers '{
  "status": "example_status",
  "page": 1,
  "limit": 1
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs recruitee --json
kosmo integrations:docs recruitee.recruitee_list_offers --json
kosmo integrations:schema recruitee.recruitee_list_offers --json
kosmo integrations:search "Recruitee" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Recruitee.

`recruitee.recruitee_list_offers`

Read read

List job offers (open positions) from Recruitee. Returns paginated results with offer titles, statuses, and metadata. Filter by status to see only open, closed, or draft positions.

Parameters: status, page, limit

Generic CLI call

kosmo integrations:call recruitee.recruitee_list_offers '{"status":"example_status","page":1,"limit":1}' --json

Provider shortcut

kosmo integrations:recruitee recruitee_list_offers '{"status":"example_status","page":1,"limit":1}' --json

`recruitee.recruitee_get_offer`

Read read

Get details for a specific job offer in Recruitee. Returns the full offer object including title, description, requirements, location, and status.

Parameters: id

Generic CLI call

kosmo integrations:call recruitee.recruitee_get_offer '{"id":1}' --json

Provider shortcut

kosmo integrations:recruitee recruitee_get_offer '{"id":1}' --json

`recruitee.recruitee_list_candidates`

Read read

List candidates from Recruitee. Returns paginated results with candidate names, emails, and application status.

Parameters: page, limit

Generic CLI call

kosmo integrations:call recruitee.recruitee_list_candidates '{"page":1,"limit":1}' --json

Provider shortcut

kosmo integrations:recruitee recruitee_list_candidates '{"page":1,"limit":1}' --json

`recruitee.recruitee_get_candidate`

Read read

Get details for a specific candidate in Recruitee. Returns the full candidate profile including contact info, resume, and application history.

Parameters: id

Generic CLI call

kosmo integrations:call recruitee.recruitee_get_candidate '{"id":1}' --json

Provider shortcut

kosmo integrations:recruitee recruitee_get_candidate '{"id":1}' --json

`recruitee.recruitee_list_departments`

Read read

List all departments in Recruitee. Returns department names and IDs that can be used to filter offers.

Parameters: none

Generic CLI call

kosmo integrations:call recruitee.recruitee_list_departments '{}' --json

Provider shortcut

kosmo integrations:recruitee recruitee_list_departments '{}' --json

`recruitee.recruitee_get_current_user`

Read read

Get the currently authenticated Recruitee user. Returns user profile info including name, email, and role.

Parameters: none

Generic CLI call

kosmo integrations:call recruitee.recruitee_get_current_user '{}' --json

Provider shortcut

kosmo integrations:recruitee recruitee_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`recruitee.recruitee_list_offers`

List job offers (open positions) from Recruitee. Returns paginated results with offer titles, statuses, and metadata. Filter by status to see only open, closed, or draft positions.

Operation: Read read
Schema command: kosmo integrations:schema recruitee.recruitee_list_offers --json

Parameter	Type	Required	Description
`status`	string	no	Filter by offer status: "open", "closed", or "draft". Omit to return all offers.
`page`	integer	no	Page number for pagination (default: 1).
`limit`	integer	no	Number of results per page (default: 20, max: 100).

`recruitee.recruitee_get_offer`

Get details for a specific job offer in Recruitee. Returns the full offer object including title, description, requirements, location, and status.

Operation: Read read
Schema command: kosmo integrations:schema recruitee.recruitee_get_offer --json

Parameter	Type	Required	Description
`id`	integer	yes	The offer ID to retrieve.

`recruitee.recruitee_list_candidates`

List candidates from Recruitee. Returns paginated results with candidate names, emails, and application status.

Operation: Read read
Schema command: kosmo integrations:schema recruitee.recruitee_list_candidates --json

Parameter	Type	Required	Description
`page`	integer	no	Page number for pagination (default: 1).
`limit`	integer	no	Number of results per page (default: 20, max: 100).

`recruitee.recruitee_get_candidate`

Get details for a specific candidate in Recruitee. Returns the full candidate profile including contact info, resume, and application history.

Operation: Read read
Schema command: kosmo integrations:schema recruitee.recruitee_get_candidate --json

Parameter	Type	Required	Description
`id`	integer	yes	The candidate ID to retrieve.

`recruitee.recruitee_list_departments`

List all departments in Recruitee. Returns department names and IDs that can be used to filter offers.

Operation: Read read
Schema command: kosmo integrations:schema recruitee.recruitee_list_departments --json

Parameter	Type	Required	Description
No parameters.

`recruitee.recruitee_get_current_user`

Get the currently authenticated Recruitee user. Returns user profile info including name, email, and role.

Operation: Read read
Schema command: kosmo integrations:schema recruitee.recruitee_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.