# DeskTime MCP MCP > DeskTime MCP gives you full control over your team's time tracking, project status, and productivity reports using natural conversation. Stop clicking through dashboards; simply ask your AI agent to list tasks for a specific project or check who is currently online. It manages everything from initial project setup to final performance scoring. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** time-tracking, workforce-management, productivity-analytics, project-costing, employee-monitoring ## Description You can connect your DeskTime account to any agent on Vinkius and manage your entire workforce data flow without leaving your chat window. Instead of manually logging time or digging through complex charts, you talk directly to the system. You tell your AI agent what you need—for example, asking for a report on last week’s company productivity—and it pulls that information instantly. Want to start a new initiative? Just ask the agent to set up and manage the project structure. It handles listing projects, creating tasks, assigning work, and even marking those tasks as complete. The system keeps track of who's available right now or gives you detailed performance reports for any employee. Your AI acts like a dedicated operations coordinator, pulling all that messy time data into clean conversations. ## Tools ### mark_task_completed Changes the status of a task to completed, logging the accomplishment. ### create_project Establishes and names a completely new work project. ### create_new_task Adds a specific task under an existing project. ### remove_project Deletes an entire project from the system records. ### get_company_info Retrieves basic details about the company organization. ### get_employee_performance Pulls specific productivity statistics for an individual employee. ### list_online_staff Checks and lists which team members are currently marked as active or online. ### get_project_details Gets specific information about a designated project by its ID or name. ### list_employees Shows a directory of all employees associated with the company account. ### list_projects Retrieves a list of all active projects managed in the system. ### get_productivity_reports Generates comprehensive reports detailing overall company performance metrics. ### list_project_tasks Lists every single task associated with a specific project ID. ## Prompt Examples **Prompt:** ``` Show me a list of all employees currently tracking time. ``` **Response:** ``` I've retrieved the online staff list. Currently, 5 employees are tracking time, including @user1 and @user2. Productivity levels are looking healthy across the team. ``` **Prompt:** ``` Check the productivity report for 'last_week'. ``` **Response:** ``` Scanning reports... Last week, the company average productivity was 84%. Total tracked time: 320 hours. Would you like a breakdown of the top performers? ``` **Prompt:** ``` Create a new task 'Review MCP API' in project ID '123'. ``` **Response:** ``` Action complete! Task 'Review MCP API' has been successfully created within project 123. Your team can now start tracking time against this specific task. ``` ## Capabilities ### Report on team activity Check current availability and pull company-wide productivity stats instantly. ### Structure projects and tasks Create new project containers or add individual, measurable tasks to existing projects. ### Track progress on assigned work Mark specific tasks as finished when the team completes them. ### View employee records Retrieve detailed information about company employees and overall business details. ### Monitor real-time status See a live list of staff members who are actively working right now. ## Use Cases ### The weekly status meeting prep A Project Manager needs to summarize the last two weeks of work for five different projects. Instead of manually going into each project and pulling reports, they prompt their agent: 'Get productivity reports for all active projects.' The agent aggregates the data immediately. ### Assigning urgent, unscheduled work A Team Lead realizes a key deliverable is stalled. They ask the agent to list_online_staff and find out who has capacity. Then they use create_new_task to assign the immediate fix to an available resource. ### Onboarding new team members An Ops Director needs a full picture of company resources for a budget review. They prompt the agent to list_employees and get_company_info, pulling all necessary organizational data in one go. ### Closing out an initiative The Project Manager finishes a major deliverable. Instead of manually updating every project status field, they prompt the agent to mark_task_completed and then remove_project, cleaning up all records at once. ## Benefits - Stop manually pulling data into spreadsheets. You can simply ask your agent to check employee stats or get productivity reports, getting the necessary numbers instantly. - Maintain project fidelity by letting the AI list projects and tasks; you won't miss any scope items just because they weren’t in a dashboard tab. - Coordinate team availability on the fly. Just asking for who is online lets your agent give you real-time status updates, so you know who to assign work to next. - Keep project records clean by using tools like create_project and remove_project; you control the entire lifecycle of a project container via chat commands. - Speed up workflow automation. You can programmatically create new tasks or mark existing ones as completed, logging progress immediately without opening another app. ## How It Works The bottom line is: your AI talks to DeskTime on your behalf, letting you manage complex work processes through simple chat commands. 1. Subscribe to this MCP on Vinkius and grab your API Key from the DeskTime settings. 2. Connect that key to any AI agent or client you use daily. 3. Start giving commands. Just ask, 'What were last month's performance reports?' or 'Create a new project for Q3 planning.' The agent runs the query and gives you the answer. ## Frequently Asked Questions **How do I start tracking time with the DeskTime MCP?** You first subscribe to this MCP and retrieve your API Key from your DeskTime settings. Once connected, you can ask your agent to create_project or list_projects to get started. **Can I check who is available using the DeskTime MCP?** Yes. You simply ask the agent to run list_online_staff, and it provides a real-time list of staff members currently tracking time. **What if I need to add a task later? Do I use create_new_task?** Yes. You tell the agent to create_new_task, and it logs that task under the proper project container, keeping your records accurate. **Is this MCP good for HR reporting?** It's excellent for Ops Leads. You can use list_employees and get_company_info to pull detailed worker directories and overall company metadata. **If I want a full list of existing projects, should I use the `list_projects` tool?** Yes, running `list_projects` returns a comprehensive overview of every active DeskTime project. This is your starting point for confirming IDs and names before you run deeper queries like getting specific project details. **When managing projects, how do I safely retire an initiative? Do I use the `remove_project` tool?** Calling `remove_project` deletes the entire project from your DeskTime account. Because this action is irreversible, always ensure you have extracted or backed up any necessary data before running this command. **If I need to understand staffing metrics, should I use `list_employees` or run `get_employee_performance`?** Use `list_employees` when you just need the company's directory of staff. If you need actual productivity scores and performance data for those employees, you must run `get_employee_performance` instead. **What is the workflow if I want to mark a task as complete? Should I check first using `list_project_tasks`?** Yes, running `list_project_tasks` shows every individual task tied to a project ID. Checking this list lets you confirm all work is visible before you use the `mark_task_completed` tool. **How do I find my DeskTime API Key?** Log in to your account, navigate to **Settings** > **Integrations**, and you will find your API Key at the bottom of the page. **Can I see who is currently online?** Yes! Use the `list_online_staff` tool to retrieve a real-time list of employees who are actively tracking their time. **Does it support detailed performance metrics?** The `get_employee_performance` tool provides granular productivity scores and time breakdown for specific dates.