How to integrate Desktime MCP with Atomic Agent

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 Desktime.

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 Desktime account. See the Atomic Agent documentation for installation instructions.

How Atomic Agent connects to Desktime

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 Desktime 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 Desktime. It searches Composio for the right tool.
4. On first use, open the sign-in link returned in the chat. Connect your Desktime 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.

The Desktime MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Desktime account. It provides structured and secure access to your time tracking, project management, and productivity data, so your agent can perform actions like tracking work hours, managing projects, analyzing employee productivity, and reporting on team activities on your behalf.

• Automated project and task management: Create new projects, assign optional starter tasks, and retrieve a comprehensive list of active company projects for streamlined organization.
• Employee and company insights: Instantly fetch detailed company account info, list all employees with their roles and statuses, and access individual employee data for better workforce visibility.
• Time tracking control: Start or stop tracking work on specific projects and tasks, enabling hands-free, accurate logging of work sessions and project contributions.
• Productivity and app usage analysis: Retrieve employee project assignments and application usage data to monitor work habits and identify productivity trends across your team.
• API health and connectivity checks: Use built-in API ping tools to verify Desktime API availability and ensure uninterrupted agent operations.

Use Desktime from Atomic Agent

With your account connected, ask Atomic Agent to work with Desktime 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.