Hubstaff Connector for AI agents.
9 live capabilities
Query workforce analytics and project timesheets in real-time.
Waiting for input…
Why people use Hubstaff
Hubstaff for Workforce Analytics and Timesheet Reporting
With this Connector, you just ask your agent. "How many hours did the dev team spend on project X last week?" You get the answer in seconds. It turns a five-minute hunt into a five-second conversation.
What Vinkius changes
You get instant access to your workforce data through a simple chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Billing Audit
A manager asks the agent to pull all time entries using list_time_entries for a specific client to verify an invoice.
- Real-world use case 02
Capacity Planning
An HR lead asks your agent to list_activities to see who is active today to see if the team can take on new work.
- Real-world use case 03
Sprint Review
A project lead pulls all sub-tasks for a project using list_tasks to see what's left on the current sprint.
Complete set · 9capabilities
The complete Hubstaff capability set.
These are the exact actions your AI can choose when you ask it to work with Hubstaff.
01—03
3 capabilities in this set.
Part of 9 available through Hubstaff.
- 01 Capability
Get user
Fetch specific details for a targeted user. This helps you quickly find a staff member's info.
- 02 Capability
Get organization
Get specific details about an organization's parameters. This is useful for understanding the scope of your account.
- 03 Capability
Get project
Retrieve a single project's structure and details. Use this to see how a specific project is organized.
04—06
3 capabilities in this set.
Part of 9 available through Hubstaff.
- 04 Capability
List activities
Retrieve all organizational activities logged in the system. Use this to see high-level team productivity.
- 05 Capability
List organizations
Retrieve the parent organizations associated with your account. This helps you navigate multiple hubs.
- 06 Capability
List projects
Retrieve all active projects linked to a specific organization. Use this to see your entire project portfolio.
07—09
3 capabilities in this set.
Part of 9 available through Hubstaff.
- 07 Capability
List tasks
Retrieve the operational sub-tasks for a given project. This gives you a granular view of work in progress.
- 08 Capability
List time entries
Read all explicitly billed or logged time blocks. Use this to pull data for invoicing or audits.
- 09 Capability
List users
Retrieve the full list of staff and employees under the hub. This is great for getting a headcount.
Set up in minutes
One URL. Then ask Hubstaff to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Hubstaff from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_DALVPbKn8hNzaGogqHV890gHQDhM6AdD26il0lil/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Hubstaff, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Hubstaff for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_DALVPbKn8hNzaGogqHV890gHQDhM6AdD26il0lil/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Hubstaff URL.
- Step 03
Save and start
Save the connection and enable Hubstaff in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"hubstaff": {
"url": "https://edge.vinkius.com/vk_preview_DALVPbKn8hNzaGogqHV890gHQDhM6AdD26il0lil/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Hubstaff
Open Agent mode in chat and ask: "Using Hubstaff, help me...". 9 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"hubstaff": {
"url": "https://edge.vinkius.com/vk_preview_DALVPbKn8hNzaGogqHV890gHQDhM6AdD26il0lil/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Hubstaff
Ask Copilot: "Using Hubstaff, help me...". 9 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"hubstaff": {
"url": "https://edge.vinkius.com/vk_preview_DALVPbKn8hNzaGogqHV890gHQDhM6AdD26il0lil/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Hubstaff
Open Cascade and ask: "Using Hubstaff, help me...". 9 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"hubstaff": {
"url": "https://edge.vinkius.com/vk_preview_DALVPbKn8hNzaGogqHV890gHQDhM6AdD26il0lil/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Hubstaff
Ask Cline: "Using Hubstaff, help me...". 9 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add hubstaff --transport http "https://edge.vinkius.com/vk_preview_DALVPbKn8hNzaGogqHV890gHQDhM6AdD26il0lil/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Hubstaff
Ask Claude: "Using Hubstaff, show me...". 9 tools are ready
Where the request belongs
Work Hubstaff can move forward.
For the project manager who's tired of hunting for timesheets or the HR lead who needs a quick snapshot of team activity without opening five different tabs.
Project Manager
Checks sprint progress and billing hours on Tuesday mornings to ensure the team is on track.
HR Lead
Pulls daily activity reports to monitor team capacity and balance workloads.
Freelance Contractor
Verifies their own tracked hours against project requirements to ensure accurate payments.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsDeputy
Equip your AI agent to manage employee rosters, track timesheets, and monitor leave requests via the Deputy API.
Insightful
Manage employee productivity, time tracking, and activity via Insightful API.
DeskTime
Understand how your team spends their workday with automatic time tracking, productivity scoring, and project cost analysis.
TrackingTime
Track how your team spends time across projects and clients with timesheets, reports, and budgeting capabilities that keep work profitable.
Personio
Orchestrate HR logistics via Personio. manage workforce lists, track specific absences, log attendances securely, and evaluate custom attributes structurally via AI.
Homebase
Automate employee scheduling and time tracking via Homebase. manage shifts, locations, and timecards directly from any AI agent.
Bring your own AI
Change the model, client or framework. Keep Hubstaff connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Hubstaff.
The practical details behind the request, access and result.
Can the Hubstaff MCP help me with billing?
Yes. It pulls all your billed time entries so you can verify hours against invoices quickly.
Does the Hubstaff MCP show who is working right now?
It can. You can ask your agent to list today's activities to see current team status.
Can I use Hubstaff MCP to manage my employees?
You can use it to see staff lists and details, but it's primarily for viewing data rather than editing profiles.
How do I see project tasks with Hubstaff MCP?
Just ask your agent to list the tasks for a specific project, and it'll show you the sub-tasks.
Is Hubstaff MCP good for freelancers?
It's great for freelancers to quickly check their own logged hours and activity snapshots.
Can Hubstaff MCP see multiple organizations?
Yes, it can list your parent organizations and then pull data for the specific ones you need.
How do I get started?
Subscribe, enter your API credentials (your generated Hubstaff PAT via User Settings → Personal access tokens), and you're set. No code, no environment files, no postbacks. just connect and audit team activity with natural text.
Can my AI check a single associate's daily activities quickly?
Yes! Direct your prompt to fetch all logged daily activities (or activities specifically). The agent will query Hubstaff, breaking down the tracking records and formatting them directly so you won't need to manually click through web portals.
How easy is it to gather organization and project specifics?
It essentially takes seconds explicitly asking 'List my organizations and projects.' The list_projects functionality traverses your environment returning the IDs you need to inspect underlying items.
Is the agent suited to handle multiple large organizational hubs at once?
Yes! Due to targeted parameter queries (e.g., retrieving timesheets by target organization), HR firms and agencies scaling hundreds of contractors can extract clean textual aggregations pain-free via simple prompts.
One connection away
Give your agent a direct line to Hubstaff.
Connect Hubstaff once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available