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,700+ 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.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

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

Get the current user's cached coding activity summary for today, broken down by projects, languages, editors, and more.

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

Retrieve a user's coding activity insight for 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.0 authorization URL.

Get User Details

Retrieve a WakaTime user's profile by ID or username, or use current for the authenticated user.

Get User's Total Time Since Creation

Retrieve a user's total coding time since account creation, optionally for a project.

Get User Stats

Retrieve a user's coding statistics for their public profile's default time range, including language, editor, project, and daily-average metrics.

Get User Stats by Range

Retrieve a user's coding statistics for a specified time range, including breakdowns by language, editor, project, and OS, daily averages, and best day.

Get User Summaries

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

List Program Languages

List a page of verified programming languages supported by WakaTime, with language metadata and pagination totals.

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

Start with Wakatime.It takes 30 seconds.

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

Start building