# WakaTime (Coding Stats) MCP for AI Agents AI Agent Connect > WakaTime (Coding Stats) lets you pull your coding activity and productivity metrics directly into your AI agent. You can monitor projects, track personal goals, and see exactly how much time you spend in your IDE without switching tabs. It turns your raw WakaTime data into actionable insights for better time management, helping you see where your day goes and which projects are taking priority. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_AB4t6k4hg7aaksv2YUC1kPAcw00en9TrAEER6qs2/ai-agent-connect - **Tags:** coding-stats, time-tracking, developer-productivity, wakatime, activity-monitoring ## Description WakaTime (Coding Stats) connects your account to your agent so you can chat about your coding habits instead of digging through dashboards. You can ask about your progress on specific projects or see how much time you actually spent on a task last week. It makes it easy to see where your time goes, whether you're trying to hit a specific coding goal or just want to know which projects are eating up your day. You'll find this useful when you're looking for a clear picture of your work patterns and want to see what actually moved the needle. Instead of exporting CSVs or scrolling through endless logs, you can just ask for a summary of your last 7 days. It gives you a clear view of your output without the manual work of tracking every minute yourself. Because Vinkius hosts this Connector, you can get these insights across any of your connected AI clients in one place. It turns your raw activity data into a conversation that helps you understand your own workflow. You can see which languages you're spending the most time in and which projects are taking priority, making it easier to plan your next sprint or just reflect on your week. For team leads, it provides a way to see high-level project activity without requiring manual reports from every developer. It puts your data where you actually work, making it easier to stay on top of your goals and your time. ## Tools ### create_external_duration Manually create an activity entry from an external app. This is useful for logging tasks that aren't automatically tracked. ### create_heartbeat Create a raw coding activity ping manually. Use this to inject specific activity into your history. ### get_all_time_since_today See your total coding time since you first created your account. This shows your entire career history with WakaTime. ### get_goal Retrieve the specific details for a single user-defined coding goal. Use this to drill down into one specific target. ### get_stats Get summarized coding statistics for a specific date range. This helps you see your weekly or monthly totals quickly. ### list_commits See a list of commits for a project along with the time spent on each. This is great for seeing how long specific features took to finish. ### list_custom_rules View rules used to modify or delete specific coding activity. You can manage how your data is filtered and cleaned. ### list_durations Get coding activity grouped into blocks based on your keystroke timeouts. This shows you chunks of focused work time. ### list_external_durations See activity logs created from external apps like Google Calendar. This helps you include meetings and other non-coding tasks. ### list_summaries Get the daily totals of your coding activity. Use this to see your consistent output day by day. ### update_custom_rules Modify the rules that determine which activity gets recorded or deleted. This lets you refine your data accuracy. ### list_goals List your custom coding goals and see how much progress you've made. Use this to track your personal milestones. ### list_heartbeats Get the raw coding activity pings sent from your IDE plugins. This provides the most granular data available for your sessions. ### list_projects See a full list of projects your IDE has detected. This gives you a bird's eye view of your active workspace. ## Prompt Examples **Prompt:** ``` How much time did I spend on the API project last week? ``` **Response:** ``` ### API Project Activity **Total Time:** 14 hours 20 minutes **Breakdown by Day:** | Day | Time Spent | |---|---| | Monday | 3h 15m | | Tuesday | 4h 00m | | Wednesday | 2h 45m | | Thursday | 4h 00m | **Top Languages:** * TypeScript (8h) * Node.js (4h) * SQL (2h 20m) ``` **Prompt:** ``` What is my progress on my current coding goals? ``` **Response:** ``` You have **2 active goals** currently: * **Code 4 hours daily:** 🟢 85% complete for this week. You're on track! * **Contribute to Open Source:** 🟡 40% complete. You've logged 5 hours this month. ``` **Prompt:** ``` Give me a summary of my activity for yesterday. ``` **Response:** ``` Yesterday, you were quite productive! **Total Time:** 6h 15m **Projects Worked On:** * **Frontend-App:** 3h 30m * **Documentation:** 1h 15m * **Bug Fixes:** 1h 30m **Key Languages:** React, CSS, and Markdown. ``` ## Capabilities ### Get summarized stats for specific date ranges Retrieve your coding totals for the week, month, or any custom period. ### List all projects detected by your IDE plugins See every project your agent can find in your workspace. ### Check progress on custom coding goals Track how close you are to hitting your personal coding milestones. ### Inspect raw heartbeats and duration blocks View the most granular data of your active coding sessions. ### View activity from external apps like Google Calendar Include meetings and other non-coding tasks in your total activity. ### List daily totals of coding activity Get a day by day breakdown of your coding output. ### Retrieve time spent on specific commits See exactly how much time was logged for each individual commit. ## Use Cases ### Checking feature work time A developer wants to know if they spent enough time on a specific feature. They ask the agent for a summary of the last 3 days. ### Monitoring team goals A lead wants to see if the team is hitting their Open Source goal. They ask for a progress report on all active goals. ### Invoicing client work A freelancer needs to bill a client for 10 hours of work. They ask the agent to list commits and time spent for a specific project. ### Identifying deep work blocks A data nerd wants to see their most active hours. They ask the agent to show their duration blocks for the week. ## Benefits - Stop manually exporting CSVs by using get_stats to get instant summaries of your work. - Track your progress on personal milestones using list_goals to see if you're hitting your targets. - Identify time-wasters in your day by inspecting raw data with list_heartbeats and list_durations. - See your work across different platforms by pulling in data from list_external_durations. - Get a clear picture of project distribution using list_projects to see which tasks take priority. - Review your historical output with get_all_time_since_today to see your total career coding time. ## How It Works The bottom line is you get instant access to your coding history through natural conversation. 1. Subscribe to the Connector and grab your WakaTime API key from your account settings. 2. Paste the key into your AI client's configuration to establish the connection. 3. Ask your agent questions about your coding time, goals, and project stats. ## Frequently Asked Questions **Can WakaTime (Coding Stats) help me see my daily coding time?** Yes, it provides daily totals of your activity so you can see your output at a glance. This helps you stay consistent with your daily habits. **How does WakaTime (Coding Stats) handle my external calendar events?** It can pull in activity from external apps like Google Calendar to give a fuller picture of your day, including meetings and non-coding tasks. **Can I use WakaTime (Coding Stats) to track specific project progress?** Yes, it lists all projects detected by your IDE and gives summaries of your activity for each project, making it easy to see where your time goes. **Does WakaTime (Coding Stats) show my coding goals?** It lists your user-defined coding goals and tells you exactly how much progress you've made on them, so you can stay on track with your targets. **Can I see my total coding time since I started?** Yes, you can pull your all-time coding stats to see your total history since account creation, giving you a great view of your career growth. **Is WakaTime (Coding Stats) good for identifying time-wasters?** You can inspect duration blocks and raw heartbeats to see exactly when you're most active or distracted, helping you optimize your workflow. **Can I get a summary of my coding activity for the last week?** Yes! Use the `get_stats` tool with the range 'last_7_days'. Your agent will return aggregated data including total time, languages used, and project breakdown. **How do I check my progress on my coding goals?** Run the `list_goals` tool to see all your active goals and their current completion percentage. You can also use `get_goal` with a specific ID for deeper details. **Can I see which projects I've been working on?** Yes, the `list_projects` tool will return a list of all projects detected by your WakaTime plugins. You can then use `list_summaries` to see time spent on them.