# TrackingTime MCP > TrackingTime connects your AI client directly to your billing data. It lets you start, stop, and log time for specific tasks or projects using natural conversation. Need a report of hours worked last month? Just ask. This server handles task creation, project oversight, and detailed time logging so you can focus on the work, not the paperwork. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** time-tracking, timesheets, billable-hours, project-budgeting, team-collaboration, productivity-analytics ## Description Forget opening a dashboard just to punch out time. This server connects your AI client directly to your billing data, letting you start, stop, and log time for specific tasks or projects using plain conversation. You'll use it when you need to manage hours without ever touching the manual input screen. ### Real-Time Time Tracking The agent controls your clock right from chat. To begin tracking work, you simply tell it to start a timer; this immediately starts recording time against a specific project or task. When you wrap up for the day or switch focus, telling the agent to stop the timer logs that elapsed time directly into your current session record. You can't lose track of hours when your AI client handles the clock. ### Building Out Your Work Structure You tell the system what needs to get done and where it belongs. To start a brand new account structure, you ask the agent to create an entire project. If that project already exists, you can add specific to-do items—or tasks—underneath it. You'll use this server to modify existing work by updating a task’s status or pushing back its due date. ### Logging and Reviewing Hours The system gives you complete control over your recorded time. If you worked hours before the clock was running, you can manually add that specific block of time using start and end dates. To check up on everything you've logged, asking for a detailed log pulls every single time entry based on date ranges or filters you specify. You also get an instant overview of your active work directory by listing all projects currently set up in the system, or pulling a comprehensive list of clients associated with those projects. ### Getting Your Ducks in a Row (Directory Info) Need to know who's on the team? The agent queries the workspace and gives you lists of every user and their roles. You can also get your own account details instantly by retrieving your current user profile information, which keeps everything accurate for payroll and billing. ### Task Management and Status Checks The server handles listing all tasks so you can see exactly what's due and what status they're in across every project. It helps keep the whole operation organized: it gives you a clear picture of your team members, lists all active projects, and lets you pull detailed time logs for accurate billing records. ## Tools ### add_time_entry Manually adds a specific block of time to your logbook with a start date and end date. ### create_project Sets up an entirely new, distinct project within your account structure. ### create_task Adds a specific to-do item that belongs under an existing project. ### get_user_profile Retrieves your current user account details and profile information. ### list_customers Provides a list of all clients associated with your projects. ### list_time_entries Fetches a detailed log of time entries based on specified date ranges or filters. ### list_projects Shows every project you currently have set up in the system. ### list_tasks Lists all tasks, allowing you to see their status and due dates within your projects. ### list_workspace_users Lists all team members connected to your workspace and their current roles. ### start_timer Immediately begins tracking time, starting the clock for a defined task or project. ### stop_timer Stops the running timer and logs the elapsed time to your current session record. ### update_task Modifies details of an existing task, such as changing its status or due date. ## Prompt Examples **Prompt:** ``` Start my timer for the 'Design Review' task. ``` **Response:** ``` Timer started! I've initiated the tracking for 'Design Review' (ID: task_10293). I'll keep the clock running until you tell me to stop. ``` **Prompt:** ``` Show me all active tasks in the 'Marketing' project. ``` **Response:** ``` I've retrieved the tasks. There are 4 active items in 'Marketing': 'Social Media Posts', 'Email Campaign Setup', 'Blog Draft v1', and 'SEO Audit'. Which one would you like to start a timer for? ``` **Prompt:** ``` What are my time logs for today? ``` **Response:** ``` Checking today's entries... You've tracked a total of 5.5 hours today: 2h on 'Backend API', 1.5h on 'Team Sync', and 2h on 'Documentation'. Great progress! ``` ## Capabilities ### Start/Stop Timers for Tasks The agent initiates or halts a timer, recording real-time activity against a specific project task. ### Create New Projects and Tasks You tell the agent to set up a new project or add a granular task within an existing project structure. ### Retrieve Time Logs The system fetches detailed time entries for any date range, allowing you to verify logged hours quickly. ### List and Filter Clients/Projects You ask the agent for a list of active projects or clients, giving you an instant overview of your work directory. ### Coordinate Team Info The agent queries the workspace to give you lists of users and team members available on specific dates. ## Use Cases ### Billing After a Big Client Meeting You just finished a planning session with Acme Corp. Instead of opening your spreadsheet and manually calculating the 3 hours spent, you tell your agent: "Log 3 hours for the Acme Corp project.". The agent runs `add_time_entry`, records the time against the correct client/project, and confirms it's logged. ### Quickly Starting Focused Work You sit down to write code. You tell your agent: "Start my timer for the API integration task.". The agent runs `start_timer`, keeping the clock running until you are done, eliminating manual time tracking at the start of deep work. ### Onboarding a New Project A new client signs on. You prompt your agent: "Create a project for 'Alpha Launch' and add tasks for discovery, design, and review.". The agent runs `create_project` followed by multiple calls to `create_task`, building the whole structure in seconds. ### Auditing Team Workload It’s end-of-month. You need a report on who worked on what. You ask your agent for time logs, specifying the date range. The agent runs `list_time_entries`, pulling all recorded hours to verify team effort and billing potential. ## Benefits - Instantly start and stop timers via commands. When you need to clock into a task, simply tell the agent to run `start_timer`. This eliminates clicking through menus and ensures your logged activity matches reality. - Maintain an accurate project directory. Use `list_customers` or `list_projects` to see all active engagements at a glance. You never have to guess which client you were working for last week again. - Handle time logging retroactively. Instead of waiting until Friday, use the agent to run `add_time_entry` right after a meeting, specifying the exact hours and project so nothing falls through the cracks. - Keep your tasks current. Need to change a deadline? Run `update_task`. This lets you modify task status or due dates directly from chat, keeping your workflow visible across the team. - See who's available when. The agent can call `list_workspace_users` to check team bandwidth and availability before you commit to a meeting time, saving scheduling back-and-forth. ## How It Works The bottom line is that you talk to your AI client like normal, but it talks to TrackingTime's API for you. 1. Subscribe to this server and provide your TrackingTime credentials. 2. Your AI client uses natural language to invoke a tool (e.g., 'Start my timer for the SEO audit'). 3. The MCP Server executes the requested action, updates your time logs, and reports the status back to your agent. ## Frequently Asked Questions **How do I use TrackingTime to log time entries?** You tell your agent, "Log 4 hours for the client project.". The system uses `add_time_entry` to record it. You can specify the exact date and task within that command. **Can I start and stop timers using TrackingTime?** Yes. Just say, "Start my timer for the Design Review.". The agent runs `start_timer` and tracks your time until you tell it to run `stop_timer`. **Does TrackingTime help me manage multiple clients?** Absolutely. You can use `list_customers` to see all accounts, and then log specific work using the client name alongside your time entry tools. **What if I need to change a project or task? Is it hard with TrackingTime?** No. You just tell your agent what needs changing (e.g., 'Update the due date for the SEO audit'). The agent executes `update_task` directly. **How many tools are in the TrackingTime MCP Server?** There are twelve specialized tools available, covering everything from creating projects to listing team members. **How do I authenticate my credentials when connecting TrackingTime to my AI agent?** You must subscribe to the server and provide your specific TrackingTime Email and Password. Your AI client uses these credentials to establish a secure connection, allowing it to access your full time tracking data. **Using list_time_entries, how can I retrieve my time logs for only last month?** Yes, you specify the desired date range in your prompt. You simply tell your agent to fetch entries between 'Start Date' and 'End Date,' and it filters the full log history accordingly. **How does TrackingTime help me see my team’s availability?** You use the list_workspace_users tool to check your team members. This function retrieves a directory of all available users, showing their names and current workspace status. **Can I start a timer for a specific task using the AI?** Yes! Use the `start_timer` tool and provide the Task ID. Your agent will instantly begin tracking time for that specific activity in your workspace. **How do I see my time logs for the last 7 days?** Run the `list_time_entries` query. Provide the `fromDate` and `toDate` in YYYY-MM-DD format to retrieve the full history of tracked blocks for that period. **Is it possible to add a time entry manually via AI?** Absolutely. Use the `add_time_entry` action. Provide the start time, end time, and the associated Task ID to register a completed block of time.