Hubstaff MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
hubstaff-mcp
MCP server for the Hubstaff v2 API. Gives Claude Code (or any MCP client) native access to team time tracking, activities, screenshots, and reports.
Tools
Tool | Description |
| Current authenticated user |
| All orgs you belong to |
| Members in an organization |
| Projects in an organization |
| Time entries (filter by user/project/date) |
| Daily activity % (keyboard/mouse) |
| Screenshot metadata + image URLs |
| Weekly team summary |
| Custom report by team member |
| Custom report by project |
| Tasks in org/project |
| Payment records |
Setup
1. Get a Personal Access Token
Go to developer.hubstaff.com/personal_access_tokens and generate a PAT.
2. Install
# Clone
git clone https://github.com/MerlinoMarketing/hubstaff-mcp.git
cd hubstaff-mcp
npm install
# Or via npx (after npm publish)
npx hubstaff-mcp3. Configure
cp .env.example .env
# Edit .env and paste your PAT4. Add to Claude Code
Add to ~/.claude/settings.json:
{
"mcpServers": {
"hubstaff": {
"command": "node",
"args": ["/path/to/hubstaff-mcp/index.js"]
}
}
}Or if installed globally via npm:
{
"mcpServers": {
"hubstaff": {
"command": "npx",
"args": ["hubstaff-mcp"]
}
}
}Auth
The PAT is actually a refresh token (90-day expiry). The server automatically:
Exchanges the PAT for an access token on first request
Caches the access token (24hr TTL)
Auto-refreshes on 401 errors
Rate Limits
Hubstaff allows 1,000 requests/hour per application. The server uses cursor-based pagination (page_start_id) for large result sets.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Read Hub Planner resources, projects, bookings and timesheets; create clients and time entries.
Track time, manage clients and projects, review timesheets, and create invoices with OAuth.
Read time entries, projects, clients, tasks and invoices; log and update tracked time.
Read tracked time and projects; create projects and start or stop timers in DeskTime.