# Wakapi MCP for AI Agents AI Agent Connect > Wakapi lets you connect your self-hosted coding time tracker to your AI agent. You can ask your agent to pull up your weekly stats, summarize project activity, or list your active projects. It's a privacy-focused alternative to popular time tracking services that turns your raw coding data into conversational insights. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_r5osF0LBoBuU2BmomIAJKWqHY9WGFvOZmxutWZ7Q/ai-agent-connect - **Tags:** coding-stats, time-tracking, wakatime, developer-productivity, open-source ## Description Wakapi is a self-hosted, open-source alternative to popular time tracking services that records your coding activity across different editors and languages. It changes that by letting your AI agent do the heavy lifting for you. Instead of hunting for data, you can just ask your agent to tell you which languages you're spending the most time on this week or give you a summary of your work on a specific client project. It pulls from your self-hosted instance, so you stay in control of your data while getting the benefits of instant analysis. When you add this to your setup via the Vinkius catalog, you're essentially giving your agent a window into your productivity habits. You can quickly see if you're hitting your goals or if a specific project is eating up more time than planned, all without leaving your chat interface. It makes managing billable hours and personal growth much easier because the data is always ready to be interpreted. You don't have to worry about manual logging or messy spreadsheets anymore. You just get the answers you need to make better decisions about your workflow. This setup removes the friction between your raw data and your actual goals. ## Tools ### get_stats This tool pulls detailed coding statistics for a specific user to see language and editor usage. It provides a clear view of your development habits over any time range. ### get_summaries This tool provides a detailed summary of your activity for specific dates or projects. It makes it easy to see your peak productivity hours at a glance. ### send_heartbeats This tool sends coding activity data to your Wakapi instance to update your timeline. It helps keep your records accurate when your editor isn't running. ### list_projects This tool provides a full list of all projects you've tracked in your Wakapi instance. It ensures your AI agent knows which projects exist for your organization. ## Prompt Examples **Prompt:** ``` How much time did I spend on the backend project last week? ``` **Response:** ``` You spent a total of 18 hours on the 'backend-api' project last week. Here's the breakdown: - **Primary Language**: Node.js (85%) - **Editor**: VS Code - **Peak Activity**: Tuesday and Wednesday Would you like a more detailed summary for those days? ``` **Prompt:** ``` List all my projects. ``` **Response:** ``` I found 14 projects in your Wakapi account. Here are the most recent ones: - website-frontend - api-backend - mobile-app-v2 - internal-tools Let me know if you'd like stats for any of these specifically. ``` **Prompt:** ``` Give me a summary of my coding stats for the last 30 days. ``` **Response:** ``` Over the last month, you've logged 120 hours of coding. **Language Distribution:** - TypeScript: 50% - Python: 30% - Go: 20% **Top Projects:** 1. 'mcp-server-wakapi' (40 hours) 2. 'client-dashboard' (35 hours) Your most active period was the second week of the month. ``` ## Capabilities ### Pull coding statistics Get a breakdown of languages and editors used over any timeframe. ### Summarize project activity Get a high-level view of your work on specific projects for certain dates. ### List all projects See every project you've tracked in your Wakapi instance at once. ### Manually send heartbeats Push specific coding activity to your timeline to keep it accurate. ## Use Cases ### Invoicing for a client A freelancer asks their agent to summarize all work done on the 'Mobile App' project last week to generate a bill. ### Learning a new language A developer asks what percentage of their time was spent in Rust this month to see if they're practicing enough. ### Project Planning An engineering manager asks for a summary of project distribution to see if the team is over-indexed on maintenance. ### Daily Review A developer asks their agent for a summary of their activity from yesterday to see if they stayed focused on the right tasks. ## Benefits - Get instant language breakdowns: See exactly how much time you're spending in TypeScript vs Python without manual logging. - Automate project reporting: Generate status updates for your clients or team leads in seconds. - Keep your portfolio organized: Ensure your agent always knows which projects are active and billable. - Maintain perfect accuracy: Manually correct your timeline when your editor doesn't capture a specific task. - Stay private: Keep all your coding data on your own self-hosted instance while still using AI to analyze it. ## How It Works The bottom line is you get instant, conversational access to your private coding productivity data. 1. Provide your Wakapi API URL and Key to connect your instance. 2. Link the Connector to your preferred AI client like Claude or Cursor. 3. Ask your agent to analyze your stats or summarize your recent work. ## Frequently Asked Questions **How does the Wakapi MCP help with my coding stats?** It connects your AI agent to your Wakapi instance so you can ask questions about your coding habits, like which languages you use most or how much time you spend in specific editors. **Can I use Wakapi MCP to track my billable hours?** Yes, you can use it to summarize activity for specific projects and date ranges, which makes it much easier to report accurate hours to your clients. **Is my data private with the Wakapi MCP?** Yes, because Wakapi is a self-hosted platform, your data stays under your control. The Connector just provides a way for your AI agent to read and summarize that data. **What if I don't use an editor that Wakapi supports?** The Connector works with whatever your Wakapi instance tracks. If your instance records the data, your AI agent can summarize it. **How do I get started with Wakapi MCP?** You'll need to subscribe to the Connector, then provide your Wakapi API URL and Key. Once connected, you can start asking your AI client for stats and summaries. **Can I manually add coding time using the Wakapi MCP?** Yes, you can use the heartbeat tool to send manual activity updates to your timeline, ensuring your records are accurate even when your editor isn't running. **How can I see my coding statistics for the last 7 days?** You can use the `get_stats` tool and specify 'last_7_days' as the range. The agent will return a breakdown of your languages, editors, and projects for that period. **Can I get a list of all projects I have ever tracked in Wakapi?** Yes! Use the `list_projects` tool. It will retrieve all project names associated with your account, allowing you to see the scope of your tracked work. **Is it possible to track activity for a specific date range?** Absolutely. Use the `get_summaries` tool by providing a 'start' and 'end' date in YYYY-MM-DD format. You can even filter this by a specific project name.