Can I use Hubstaff as a CLI?

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

Can I expose Hubstaff through MCP?

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

Where are Hubstaff credentials stored?

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

Can I deny write access for Hubstaff MCP tools?

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

productivity

Hubstaff CLI for Headless Automation

Use the Hubstaff CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

7 functions 6 read 1 write Bearer token auth

Submit Hubstaff feedback View package source

Hubstaff CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The Hubstaff CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Hubstaff CLI for Headless Automation
kosmokrator integrations:configure hubstaff --set access_token="$HUBSTAFF_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call hubstaff.hubstaff_list_time_entries '{"startTime":"example_startTime","endTime":"example_endTime","userIds":"example_userIds","projectId":1,"limit":1,"page":1}' --json

Discovery Before Execution

Agents and scripts can inspect Hubstaff docs and schemas before choosing a function.

kosmo integrations:docs hubstaff --json
kosmo integrations:docs hubstaff.hubstaff_list_time_entries --json
kosmo integrations:schema hubstaff.hubstaff_list_time_entries --json
kosmo integrations:search "Hubstaff" --json
kosmo integrations:list --json

Useful Hubstaff CLI Functions

Function	Type	Parameters	Description
`hubstaff.hubstaff_list_time_entries`	Read	startTime, endTime, userIds, projectId, limit, page	List time entries from Hubstaff. Supports filtering by date range, user IDs, and project ID. Returns tracked time entries with duration, notes, and associated project/user information.
`hubstaff.hubstaff_get_time_entry`	Read	id	Get details for a specific Hubstaff time entry by its ID. Returns the full time entry record including duration, notes, project, and user information.
`hubstaff.hubstaff_create_time_entry`	Write	project_id, date, duration, notes	Create a new manual time entry in Hubstaff. Requires a project ID, date, and duration. Optionally add notes to describe the work performed.
`hubstaff.hubstaff_list_projects`	Read	status, limit, page	List projects from Hubstaff. Optionally filter by status (active, archived). Supports pagination to browse through large numbers of projects.
`hubstaff.hubstaff_get_project`	Read	id	Get details for a specific Hubstaff project by its ID. Returns project name, status, budget, and other metadata.
`hubstaff.hubstaff_list_organizations`	Read	limit, page	List organizations the authenticated user belongs to in Hubstaff. Returns organization names, IDs, and other metadata. Supports pagination.
`hubstaff.hubstaff_get_current_user`	Read	none	Get the profile of the currently authenticated Hubstaff user. Returns name, email, timezone, and other account information.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Hubstaff CLI Pages

CI Hubstaff CLI for CI. Cron Jobs Hubstaff CLI for cron jobs. Shell Scripts Hubstaff CLI for shell scripts. Coding Agents Hubstaff CLI for coding agents.