How to connect Wakatime to Claude

Connect Claude Web, Desktop and Cowork to Wakatime MCP. Show your top coding languages this week, summarize today's coding activity by project, and more using natural language, with authentication handled for you.

Wakatime logoWakatime
Oauth2

Wakatime is an automatic time tracking service for developers, integrating directly with code editors. It helps you understand coding patterns, project focus, and productivity with detailed dashboards.

17 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Wakatime account to Claude via Composio Connect, enabling it to show your top coding languages this week, summarize today's coding activity by project, list your most productive coding days last month, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Wakatime with

Connecting Wakatime to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Wakatime account

Back in Claude, ask it to connect to Wakatime or give it any Wakatime-related task.

For example, ask Claude to:

  • "Show your top coding languages this week"
  • "Summarize today's coding activity by project"
  • "List your most productive coding days last month"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Wakatime account is ready to use.

What is the Wakatime Claude Connector, and what's possible with it?

The Wakatime MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Wakatime account. It provides structured and secure access to your coding activity and productivity data, so your agent can analyze time spent coding, summarize project progress, generate reports, and surface productivity trends on your behalf.

  • Code activity summaries and analytics: Your agent can pull detailed breakdowns of your coding hours by language, project, or editor to help you understand where your time goes.
  • Project progress tracking: Get automatic updates on how much time you've dedicated to individual projects, making it easy to monitor deadlines and progress.
  • Personal productivity insights: Let your agent surface trends, highlight most productive days or hours, and offer suggestions for improving your workflow based on historical data.
  • Automated weekly and monthly reports: Have the agent generate and deliver summary reports of your coding habits, helping you spot patterns and areas for improvement.
  • Goal tracking and notifications: Enable your agent to track coding goals and notify you when milestones are reached or if you're falling behind.

Troubleshooting

1. Why does Claude not use the Composio connector for Wakatime?

The connector can show as connected, but Claude must use it in each Wakatime conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Wakatime again.

2. Why does Claude show an MCP server error before Wakatime connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Wakatime.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Wakatime.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Wakatime authorization link not work?

The Composio connector is one server. Your Wakatime account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Wakatime connection.
  • Composio creates a fresh Wakatime authorization link.
  • Open that link in your browser and finish the Wakatime sign-in.

4. Why do Wakatime actions fail after they worked before?

The Wakatime connection can expire or lose permission.

  • Ask Claude to inspect the Wakatime connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Wakatime account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Wakatime.
  • If the action still fails with a permission error, check that the connected account has that permission in Wakatime itself.

5. How do I switch to a different Wakatime account?

Claude can manage the Wakatime connection for you.

  • Ask Claude to disconnect or delete the current Wakatime account.
  • Ask Claude to connect Wakatime again.
  • Open the new Composio authorization link for Wakatime.
  • Sign in with the other Wakatime account in the browser.
  • After the account connects, ask Claude to retry the Wakatime task.

6. Why is my Wakatime connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Wakatime connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click and click Clear cache.
  • If Wakatime tools still do not appear, click , disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Wakatime.
TOOLS

Supported Tools

Every Wakatime action and event your agent gets out of the box.

Get Aggregate Stats

Tool to retrieve aggregate coding statistics across all WakaTime users for a given time range.

Get current user's status bar summary for today

Tool to get current user's coding activity today for displaying in IDE status bars.

List IDE Plugins

Tool to list WakaTime IDE plugins with metadata.

List Goals

Tool to list a user's goals with progress series and metadata.

Get User Insight

Tool to retrieve an insight for a user over a time range.

List Leaders

Tool to list public leaders ranked by coding activity.

List Machine Names

Tool to list a user's machines including last seen time.

Get API Meta Information

Tool to retrieve WakaTime API meta information, including public IP addresses used by WakaTime servers.

Generate WakaTime OAuth authorize URL

Tool to generate OAuth 2.

Get User Details

Tool to get detailed profile information for a WakaTime user by user ID or username.

Get User's Total Time Since Creation

Tool to retrieve total coding time since account creation for a user.

Get User Stats

Tool to retrieve coding statistics for a user over the default time range.

Get User Stats by Range

Tool to retrieve comprehensive coding statistics for a user over a specific time range.

Get User Summaries

Get user's coding activity for a time range as daily summaries.

List Program Languages

Tool to list all verified program languages supported by WakaTime.

List User Projects

List WakaTime projects for a specified user.

List User Agents

Tool to list plugins and editors which have sent data for a specified user.

FAQ

Frequently asked questions

With a standalone Wakatime MCP server, the agents and LLMs can only access a fixed set of Wakatime tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Wakatime and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Wakatime tools.

Yes, absolutely. You can configure which Wakatime scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Wakatime data and credentials are handled as safely as possible.

Start with Wakatime.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Wakatime tool your agent needs.Free to start.

Start building