# ClickTime MCP MCP > ClickTime gives your AI agent full control over time tracking and resource management data. Instead of opening dashboards, you ask natural language questions to list client accounts, check project details, audit completed time entries, or pull high-volume reports instantly. It brings the operational side of billing right into your chat window. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** time-tracking, billable-hours, resource-planning, timesheets, project-costing, audit-logs ## Description Managing billable hours shouldn't require clicking through five different tabs just to find a single piece of data. This MCP connects your ClickTime account directly to your AI agent, letting you audit client hours and check project progress using natural conversation. You can pull detailed time reports, see every user in the company, or list all available work types—all without leaving your chat interface. It's about getting immediate answers on resource allocation and billing completeness, making it a core component of any Vinkius-managed data catalog. Use this to get instant clarity on who worked where, when they worked it, and how many hours it was worth. ## Tools ### get_my_clicktime_profile Shows basic information about the user currently logged into ClickTime. ### get_high_volume_time_report Pulls large sets of time entries, useful for mass data analysis or year-end billing reports. ### list_clicktime_clients Retrieves a list of all client accounts configured in your system. ### list_clicktime_jobs Lists every job code, whether it's currently active or paused. ### list_clicktime_projects Provides a list of all projects that have been set up in ClickTime. ### list_clicktime_tasks Gets the names and codes for every type of task available to track time against. ### list_time_entries Retrieves a list of specific time entries, allowing you to see work history for a given period or person. ### list_clicktime_users Lists all people who have accounts within the company structure. ## Prompt Examples **Prompt:** ``` List all time entries from today in ClickTime. ``` **Response:** ``` Retrieving your time entries for today... I found 2 entries: 'Internal Meeting' (1.5 hrs) and 'Feature Development' (4.0 hrs). Total so far is 5.5 hours. ``` **Prompt:** ``` Show me all clients configured in my account. ``` **Response:** ``` Checking client list... You have 5 active clients: Acme Corp, Global Tech, Startup Inc, Fast Services, and Blue Media. Would you like to see projects for any of these? ``` **Prompt:** ``` What is the high-volume time report status? ``` **Response:** ``` Retrieving high-volume report... The system returned 2,150 time entries for the current period. All records are processed and ready for analysis. ``` ## Capabilities ### Generate time reports Requests detailed records of time entries, supporting up to 2500 data points at once. ### List clients and jobs Retrieves a complete list of all active and inactive client accounts and associated job codes. ### Audit project structures Lists every project configured in your account, allowing you to see which resources are assigned where. ### Check team roster Provides a list of all people and users associated with the company's accounts. ### Review time entries Retrieves specific records detailing when work was performed, along with descriptions for those hours. ## Use Cases ### The End-of-Month Billing Audit An accountant needs to check if all client projects have been billed correctly. Instead of pulling 10 different reports, they prompt their agent: 'Give me a high-volume time report for Q2.' The agent runs `get_high_volume_time_report` and returns the full data set immediately. ### Resource Allocation Check A project manager is planning next quarter. They ask their agent to run 'List all users' (`list_clicktime_users`) and cross-reference that list with active projects (`list_clicktime_projects`) to see who is currently overloaded. ### Client Onboarding Prep An ops coordinator needs client details for a new pitch deck. They ask the agent to 'List all clients' (`list_clicktime_clients`), which gives them an immediate, accurate list they can copy and paste. ### Verifying Work Types A contributor is logging time for a new task. They ask the agent to 'What tasks are available?' The agent uses `list_clicktime_tasks` and provides the list, ensuring they select the correct work type code. ## Benefits - Stop clicking through dashboards just to check a roster. Use `list_clicktime_users` to instantly get the company's entire user list right in your agent conversation. - Never miss a billing deadline again. Run massive data pulls using `get_high_volume_time_report` for comprehensive, bulk auditing that used to take manual exports and spreadsheet work. - Need context? Before logging time, use `list_clicktime_tasks` to ensure you're picking the right category code every single time. It keeps your data clean from day one. - See the big picture fast. Use `list_clicktime_projects` combined with `list_clicktime_clients` to understand which projects are attached to which accounts without opening a single tab. - Verify employee details instantly. Check your own profile using `get_my_clicktime_profile` to confirm authentication data or review personal time logs when you need it. ## How It Works The bottom line is you get instant access to complex business records without ever having to log into a separate web dashboard. 1. First, you subscribe to this MCP and provide your ClickTime API Token via the Vinkius platform. 2. Next, you simply prompt your AI agent using conversational language (e.g., 'What was the total time logged for Acme Corp last month?'). 3. The system executes the necessary tool calls and returns structured data that your agent translates into a simple, readable answer in your chat. ## Frequently Asked Questions **How do I see all my clients using list_clicktime_clients?** Simply ask your agent to 'list all clients.' It runs the tool and shows you a full, up-to-date list of every client configured in your account. **What is the difference between getting time reports and listing entries with list_time_entries?** Listing entries (`list_time_entries`) gives you specific records based on criteria. The high-volume report (`get_high_volume_time_report`) pulls a massive, compiled dataset optimized for large-scale auditing. **Can I see all users with list_clicktime_users?** Yes. Requesting to 'list all people' will execute `list_clicktime_users` and give you a complete roster of every user in the company, including their IDs. **How do I find out what tasks are available for time tracking?** You use the `list_clicktime_tasks` tool. Just ask your agent to 'show me all task types' and it will give you the full catalog of codes and names. **How do I verify my authentication status using get_my_clicktime_profile?** It returns your current user profile details. This includes essential info like your unique ID and email address, letting you confirm the credentials linked to this MCP. **What does list_clicktime_projects show about my client work?** This tool lists every project configured in ClickTime. You get a full overview of both active client accounts and internal initiatives, helping you map out where time is being spent. **Can I use list_clicktime_jobs to see inactive work categories?** Yes, this tool lists all job types in the system, whether they are active or archived. It provides a complete audit view of your company's historical and current billing categories. **What is the data limit when running get_high_volume_time_report?** The report retrieves up to 2,500 time entries per request. If you need a larger dataset, you will need to run multiple calls or use an export feature within your main ClickTime dashboard. **Can I see my total hours for this week?** Yes! Use the `list_time_entries` tool. The agent will return your recent entries, and you can ask it to sum the hours for the current week. **How do I check which projects are currently active?** Use the `list_clicktime_projects` tool. Your agent will fetch all projects in the system, including their names and statuses. **Where do I find my ClickTime API Token?** You can obtain your token by making a Basic Auth request to the `GET /Me` endpoint using your email and password. Alternatively, check your ClickTime profile or contact your administrator.