# Hubstaff MCP > Hubstaff brings your entire workforce analytics into a natural conversation using its MCP connector. Get detailed reports on time allocation, track daily activities across teams, and query organizational structures without leaving your chat interface. It lets you instantly analyze users, projects, and billing-ready timesheets from any AI agent. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** time-tracking, workforce-management, timesheets, activity-monitoring, employee-productivity, task-management ## Description Connect your Hubstaff account to any compatible AI client and treat your workforce data like a conversation. Instead of navigating multiple dashboards or exporting dozens of spreadsheets, you simply ask for what you need—whether it's the list of parent organizations, who worked on Project Alpha this week, or a summary of daily tracked activity for Sarah. Your agent pulls complex data sets, including individual time entries and task structures, and presents them right away. This makes reviewing labor costs or generating billing summaries fast. By connecting through Vinkius, you get immediate access to Hubstaff's full range of tools, giving your AI client a complete picture of team performance. You can analyze project scope by retrieving the list of active projects, then fetch precise timesheets for every user involved. ## Tools ### get_organization Gets core parameters defining your entire organization structure. ### get_project Retrieves the complete setup and details for a single project. ### get_user Fetches all specific profile and access details for an individual employee. ### list_activities Reads global records of every activity that has been logged by any user. ### list_organizations Retrieves a list of all parent organizations connected to the hub. ### list_projects Gets a full roster of every project currently running within your organization. ### list_tasks Pulls operational sub-task listings for any given project. ### list_time_entries Reads all specific time blocks that have been logged and potentially billed to a client. ### list_users Retrieves the full list of all staff members and employees on file. ## Prompt Examples **Prompt:** ``` Can you check my Hubstaff dashboard and list the organizations I have access to? ``` **Response:** ``` Absolutely. I found 1 registered organization called 'Central Dev Agency' under the ID block 50293. ``` **Prompt:** ``` Retrieve all the timesheets available so I can verify billing. ``` **Response:** ``` Inspecting timesheets... The endpoint has returned 3 fresh entries logging roughly 18 active worked hours combined across your teams. ``` **Prompt:** ``` List today's daily activities tracked in the organization. ``` **Response:** ``` Checking daily logs... I've retrieved today's activity entries. User Sarah has 4 hours tracked with an 85% average activity score. ``` ## Capabilities ### List organizational structures Retrieves details about parent organizations that house your teams and projects. ### Fetch specific user profiles Pulls targeted details for any employee or staff member within the system. ### Track daily activities Gathers global activity logs, showing how time is actively allocated across the organization. ### Determine project lists Retrieves a comprehensive list of all active projects linked to your main account. ### Read billing-ready timesheets Reads logged time blocks, specifically those marked as billable or tracked over specific periods. ## Use Cases ### Verifying billing hours for a client A PM needs to prove how many billable hours were logged last month. They ask their agent to read all time entries, and the MCP pulls exactly what's needed via list_time_entries without needing date filters or complex reports. ### Auditing user access across departments An HR lead needs a quick overview of who is employed. They use the agent to retrieve the full staff and employee directory using list_users, giving them immediate confirmation of staffing levels. ### Understanding project scope creep A manager suspects tasks are falling through the cracks. They run a query to get all active projects (list_projects) and then check for operational sub-tasks (list_tasks) per project to find gaps. ### Reviewing daily team performance A freelancer needs quick proof of work. They ask the agent to list today's global activities, which instantly pulls logged activity snapshots for review. ## Benefits - Stop jumping between tabs. You can analyze the full organizational structure and get user lists in one chat query, eliminating context switching. - Billing summary creation is instant. Instead of manually checking project dashboards, you ask for all timesheets related to specific projects using list_time_entries. - Track team activity with precision. Use list_activities to see who was doing what and when, providing immediate accountability reports. - HR reporting gets simpler. You can get daily time sheet overviews or fetch targeted user details without running through the full employee directory. - Project scoping is clearer. Get a complete roster of all projects via list_projects, then drill down to operational sub-tasks with list_tasks when needed. ## How It Works The bottom line is you get complex, multi-tab dashboard information delivered through natural chat prompts. 1. Subscribe to this MCP and provide your Personal Access Token from Hubstaff V2. 2. Your AI client authenticates the connection, giving it full read access to your workforce data. 3. You prompt your agent with a request—like 'Show me all timesheets for Q3'—and receive structured, actionable results instantly. ## Frequently Asked Questions **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.