productivity
Hubstaff MCP Integration for CrewAI
Connect Hubstaff to CrewAI through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.
Connect Hubstaff to CrewAI
Expose KosmoKrator integrations to CrewAI workers as scoped local tools.
Wrap kosmo integrations:call for specific tasks or connect workers to a local MCP gateway. The gateway is local, scoped to this integration, and starts with
--write=deny so CrewAI can inspect read-capable tools without receiving write access by default.
Hubstaff MCP Config for CrewAI
Use per-worker integration scopes to avoid giving every worker every tool.
{
"mcpServers": {
"kosmokrator-hubstaff": {
"type": "stdio",
"command": "kosmo",
"args": [
"mcp:serve",
"--integration=hubstaff",
"--write=deny"
]
}
}
} Run the Gateway Manually
kosmokrator mcp:serve --integration=hubstaff --write=deny Why Use KosmoKrator Here
Expose only Hubstaff instead of a broad multi-service tool list.
Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.
Start read-only, then opt into ask or allow for trusted workspaces.
Hubstaff Tools Visible to CrewAI
CrewAI sees stable MCP tool names generated from the Hubstaff integration catalog.
| MCP tool | Source function | Type | Description |
|---|---|---|---|
integration__hubstaff__hubstaff_list_time_entries | hubstaff.hubstaff_list_time_entries | Read | 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. |
integration__hubstaff__hubstaff_get_time_entry | hubstaff.hubstaff_get_time_entry | Read | Get details for a specific Hubstaff time entry by its ID. Returns the full time entry record including duration, notes, project, and user information. |
integration__hubstaff__hubstaff_create_time_entry | hubstaff.hubstaff_create_time_entry | Write | Create a new manual time entry in Hubstaff. Requires a project ID, date, and duration. Optionally add notes to describe the work performed. |
integration__hubstaff__hubstaff_list_projects | hubstaff.hubstaff_list_projects | Read | List projects from Hubstaff. Optionally filter by status (active, archived). Supports pagination to browse through large numbers of projects. |
integration__hubstaff__hubstaff_get_project | hubstaff.hubstaff_get_project | Read | Get details for a specific Hubstaff project by its ID. Returns project name, status, budget, and other metadata. |
integration__hubstaff__hubstaff_list_organizations | hubstaff.hubstaff_list_organizations | Read | List organizations the authenticated user belongs to in Hubstaff. Returns organization names, IDs, and other metadata. Supports pagination. |
integration__hubstaff__hubstaff_get_current_user | hubstaff.hubstaff_get_current_user | Read | Get the profile of the currently authenticated Hubstaff user. Returns name, email, timezone, and other account information. |