Skip to content

WakaTime MCP #1184

@O-Q

Description

@O-Q

Is your feature request related to a problem? Please describe.

Currently, accessing detailed WakaTime statistics requires visiting the web dashboard or making manual API
calls. While the dashboard is excellent, it forces a context switch away from the IDE. With the rise of AI
assistants integrated directly into editors (like Continue, Codeium, etc.), there's a new opportunity to
interact with development data in a more conversational and seamless way. These tools often use a local
server backend, like one that implements the Model Catalog and Provider (MCP) protocol.

Describe the solution you'd like

I propose that the wakatime-cli be enhanced with a new mode that runs it as an MCP-compliant server. This
server would act as a specialized AI assistant for querying personal or team-based WakaTime data using
natural language.

How it would work:

  1. A user would run a command like wakatime-cli --serve-mcp.
  2. The CLI starts a local server that listens for requests from MCP clients (e.g., an IDE extension).
  3. A user could then ask questions in their MCP compatible programs like:
    • "How many hours did I code last week?"
    • "What was my most used language yesterday?"
    • "Show me the time breakdown for my 'wakatime-cli' project."
    • "What was the total coding activity for my team on Project X this month?"
  4. The wakatime-cli server would be responsible for:
    • Providing tools (functions) via MCP protocol using WakaTime API calls

Describe alternatives you've considered

  • Building a Separate Tool: A standalone tool could achieve this, but integrating it directly into the
    official wakatime-cli would provide a more robust, secure, and streamlined solution for all users. It would
    become an official, trusted entry point for this kind of interaction.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions