How to integrate Wakatime MCP with Atomic Agent

Connect Atomic Agent 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

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Wakatime.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Wakatime account. See the Atomic Agent documentation for installation instructions.

Also integrate Wakatime with

How Atomic Agent connects to Wakatime

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Wakatime to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Wakatime. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Wakatime account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Wakatime MCP server, 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.

Use Wakatime from Atomic Agent

With your account connected, ask Atomic Agent to work with Wakatime in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

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. Atomic Agent 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