Use
COMPOSIOFOR YOU
Give Claude, Codex, or any harness secure access to 1700+ tools
CLI
One command to add tools and auth to your coding agent
Build
DEVELOPER PLATFORM
SDKs, tools, and auth for agents and backend apps
MCP GATEWAY
One managed MCP endpoint for all your tools and agents
ENTERPRISE
SSO, governance, and audit controls for deploying agents org-wide
Features
TRIGGERS
Start background agents from events across your connected apps
FIREWALLNEW
Blocks instructions hidden in tool results before your agent reads them
INSTANTNEW
Audio, video, search, browser and data tools, with no keys to manage
OPTIMIZATION
Lower cost per completed task with optimised tools and skills
FOR AGENTS
CLAUDE CODEX OPENCLAW CURSOR HERMES
BUILT FOR
OFFICE WORK SALES MARKETING PRODUCT & DESIGN CUSTOMER SUPPORT ENGINEERING HR & RECRUITING FINANCE & OPS E-COMMERCE CONTENT & MEDIA IT & SECURITY
ALL USE CASES
DOCS

How to integrate Clockify MCP with Google ADK

Connect Google ADK to Clockify MCP. List all your active workspaces, add a new client to marketing workspace, and more using natural language, with authentication handled for you.

Get started for free Get a demo

Clockify

Api KeyOauth2

Clockify is a free time tracking software for individuals and teams to monitor work hours across projects. Track, manage, and report time for better productivity and transparency.

74 Tools

Managed auth

Connect Clockify without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Book a call

Explore the MCP Gateway

Introduction

This guide walks you through connecting Clockify to Google ADK using the Composio tool router. By the end, you'll have a working Clockify agent that can log time entries, manage projects and tasks, generate detailed and weekly reports, organize clients and tags, and stop running timers through natural language commands.

This guide will help you understand how to give your Google ADK agent real control over a Clockify account through Composio's Clockify MCP server.

Before we dive in, let's take a quick look at the key ideas and tools involved.

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

Also integrate Clockify with

Claude Code Claude Cowork OpenAI Agents SDK Claude Agent SDK Codex OpenClaw Hermes Atomic Agent LangChain Vercel AI SDK Mastra AI LlamaIndex CrewAI Pydantic AI AutoGen

TL;DR

Here's what you'll learn:

Get a Clockify account set up and connected to Composio
Install the Google ADK and Composio packages
Create a Composio Tool Router session for Clockify
Build an agent that connects to Clockify through MCP
Interact with Clockify using natural language

What is Google ADK?

Google ADK (Agents Development Kit) is Google's framework for building AI agents powered by Gemini models. It provides tools for creating agents that can use external services through the Model Context Protocol.

Key features include:

Gemini Integration: Native support for Google's Gemini models
MCP Toolset: Built-in support for Model Context Protocol tools
Streamable HTTP: Connect to external services through streamable HTTP
CLI and Web UI: Run agents via command line or web interface

What is the Clockify MCP server, and what's possible with it?

The Clockify MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Clockify account. It provides structured and secure access to your team's time tracking data, so your agent can perform actions like managing clients, handling workspace users, setting up webhooks, and retrieving workspace details on your behalf.

Workspace user management: Let your agent list all users in a workspace, filter users by advanced criteria, or find team managers for more efficient team organization.
Client creation and deletion: Easily create new clients or remove existing ones from your workspace, streamlining project onboarding and cleanup.
Webhook automation: Enable your agent to create, delete, and manage webhooks for real-time notifications and integrations with other tools.
Workspace overview and navigation: Retrieve a list of all workspaces you belong to, empowering your agent to access and organize time tracking across multiple teams or projects.
Addon and webhook token management: Generate new webhook tokens and list all addon webhooks, ensuring secure and automated integrations with third-party services.

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK

The tool router generates a secure MCP URL that your agents can access to perform actions.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step09 STEPS

Prerequisites

Before starting, make sure you have:

A Google API key for Gemini models
A Composio account and API key
Python 3.9 or later installed
Basic familiarity with Python

Getting API Keys for Google and Composio

Google API Key

Go to Google AI Studio and create an API key.
Copy the key and keep it safe. You will put this in GOOGLE_API_KEY.

Composio API Key and User ID

Log in to the Composio dashboard.
Go to Settings → API Keys and copy your Composio API key. Use this for COMPOSIO_API_KEY.
Decide on a stable user identifier to scope sessions, often your email or a user ID. Use this for COMPOSIO_USER_ID.

Install dependencies

bash

pip install google-adk composio python-dotenv

Inside your virtual environment, install the required packages.

What's happening:

google-adk is Google's Agents Development Kit
composio connects your agent to Clockify via MCP
python-dotenv loads environment variables

Set up ADK project

bash

adk create my_agent

Set up a new Google ADK project.

What's happening:

This creates an agent folder with a root agent file and .env file

Set environment variables

bash

GOOGLE_API_KEY=your-google-api-key
COMPOSIO_API_KEY=your-composio-api-key
COMPOSIO_USER_ID=your-user-id-or-email

Save all your credentials in the .env file.

What's happening:

GOOGLE_API_KEY authenticates with Google's Gemini models
COMPOSIO_API_KEY authenticates with Composio
COMPOSIO_USER_ID identifies the user for session management

Import modules and validate environment

python

import os
import warnings

from composio import Composio
from dotenv import load_dotenv
from google.adk.agents.llm_agent import Agent
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset

load_dotenv()

warnings.filterwarnings("ignore", message=".*BaseAuthenticatedTool.*")

GOOGLE_API_KEY = os.getenv("GOOGLE_API_KEY")
COMPOSIO_API_KEY = os.getenv("COMPOSIO_API_KEY")
COMPOSIO_USER_ID = os.getenv("COMPOSIO_USER_ID")

if not GOOGLE_API_KEY:
    raise ValueError("GOOGLE_API_KEY is not set in the environment.")
if not COMPOSIO_API_KEY:
    raise ValueError("COMPOSIO_API_KEY is not set in the environment.")
if not COMPOSIO_USER_ID:
    raise ValueError("COMPOSIO_USER_ID is not set in the environment.")

What's happening:

os reads environment variables
Composio is the main Composio SDK client
GoogleProvider declares that you are using Google ADK as the agent runtime
Agent is the Google ADK LLM agent class
McpToolset lets the ADK agent call MCP tools over HTTP

Create Composio client and Tool Router session

python

composio_client = Composio(api_key=COMPOSIO_API_KEY)

composio_session = composio_client.create(
    user_id=COMPOSIO_USER_ID,
    toolkits=["clockify"],
)

COMPOSIO_MCP_URL = composio_session.mcp.url,
print(f"Composio MCP URL: {COMPOSIO_MCP_URL}")

What's happening:

Authenticates to Composio with your API key
Declares Google ADK as the provider
Spins up a short-lived MCP endpoint for your user and selected toolkit
Stores the MCP HTTP URL for the ADK MCP integration

Set up the McpToolset and create the Agent

python

composio_toolset = McpToolset(
    connection_params=StreamableHTTPConnectionParams(
        url=COMPOSIO_MCP_URL,
        headers={"x-api-key": COMPOSIO_API_KEY}
    )
)

root_agent = Agent(
    model="gemini-2.5-flash",
    name="composio_agent",
    description="An agent that uses Composio tools to perform actions.",
    instruction=(
        "You are a helpful assistant connected to Composio. "
        "You have the following tools available: "
        "COMPOSIO_SEARCH_TOOLS, COMPOSIO_MULTI_EXECUTE_TOOL, "
        "COMPOSIO_MANAGE_CONNECTIONS, COMPOSIO_REMOTE_BASH_TOOL, COMPOSIO_REMOTE_WORKBENCH. "
        "Use these tools to help users with Clockify operations."
    ),
    tools=[composio_toolset],
)

print("\nAgent setup complete. You can now run this agent directly ;)")

What's happening:

Connects the ADK agent to the Composio MCP endpoint through McpToolset
Uses Gemini as the model powering the agent
Lists exact tool names in instruction to reduce misnamed tool calls

Run the agent

bash

# Run in CLI mode
adk run my_agent

# Or run in web UI mode
adk web

Execute the agent from the project root. The web command opens a web portal where you can chat with the agent.

What's happening:

adk run runs the agent in CLI mode
adk web . opens a web UI for interactive testing

Complete Code

Here's the complete code to get you started with Clockify and Google ADK:

python

import os
import warnings

from composio import Composio
from composio_google import GoogleProvider
from dotenv import load_dotenv
from google.adk.agents.llm_agent import Agent
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset

load_dotenv()
warnings.filterwarnings("ignore", message=".*BaseAuthenticatedTool.*")

GOOGLE_API_KEY = os.getenv("GOOGLE_API_KEY")
COMPOSIO_API_KEY = os.getenv("COMPOSIO_API_KEY")
COMPOSIO_USER_ID = os.getenv("COMPOSIO_USER_ID")

if not GOOGLE_API_KEY:
    raise ValueError("GOOGLE_API_KEY is not set in the environment.")
if not COMPOSIO_API_KEY:
    raise ValueError("COMPOSIO_API_KEY is not set in the environment.")
if not COMPOSIO_USER_ID:
    raise ValueError("COMPOSIO_USER_ID is not set in the environment.")

composio_client = Composio(api_key=COMPOSIO_API_KEY, provider=GoogleProvider())

composio_session = composio_client.create(
    user_id=COMPOSIO_USER_ID,
    toolkits=["clockify"],
)

COMPOSIO_MCP_URL = composio_session.mcp.url


composio_toolset = McpToolset(
    connection_params=StreamableHTTPConnectionParams(
        url=COMPOSIO_MCP_URL,
        headers={"x-api-key": COMPOSIO_API_KEY}
    )
)

root_agent = Agent(
    model="gemini-2.5-flash",
    name="composio_agent",
    description="An agent that uses Composio tools to perform actions.",
    instruction=(
        "You are a helpful assistant connected to Composio. "
        "You have the following tools available: "
        "COMPOSIO_SEARCH_TOOLS, COMPOSIO_MULTI_EXECUTE_TOOL, "
        "COMPOSIO_MANAGE_CONNECTIONS, COMPOSIO_REMOTE_BASH_TOOL, COMPOSIO_REMOTE_WORKBENCH. "
        "Use these tools to help users with Clockify operations."
    ),  
    tools=[composio_toolset],
)

print("\nAgent setup complete. You can now run this agent directly ;)")

Conclusion

You've successfully integrated Clockify with the Google ADK through Composio's MCP Tool Router. Your agent can now interact with Clockify using natural language commands.

Key takeaways:

The Tool Router approach dynamically routes requests to the appropriate Clockify tools
Environment variables keep your credentials secure and separate from code
Clear agent instructions reduce tool calling errors
The ADK web UI provides an interactive interface for testing and development

You can extend this setup by adding more toolkits to the toolkits array in your session configuration.

TOOLS

Supported Tools

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

Add User to Group

Tool to add a user to a user group in a Clockify workspace.

Create Client

Tool to add a new client to a workspace.

Create New Project

Create a project in a Clockify workspace with a name and optional color, billable status, and client association.

Create Shared Report

Create a shared summary, detailed, or weekly report with a date range and summary grouping options in a Clockify workspace.

Create Tag

Create a named tag in a Clockify workspace.

Create Task

Tool to add a new task to a project in Clockify.

Create Templates On Workspace

Create one or more templates in a Clockify workspace with associated projects and optional time entries.

Create Time Entry

Tool to create a new time entry in a Clockify workspace.

Create User Group

Tool to create a new user group in a workspace.

Create User Time Entry

Tool to create a time entry for another user in a Clockify workspace.

Create Webhook

Tool to create a new webhook in a workspace.

Create Workspace

Creates a new Clockify workspace for time tracking and project management in the specified organization.

Delete Client

Deletes a client from a Clockify workspace.

Delete Project

Tool to delete a project from a workspace.

Delete Shared Report

Tool to delete a shared report from a workspace by ID.

Delete Tag

Tool to delete a tag from a Clockify workspace.

Delete Task

Tool to delete a task from a project in Clockify.

Delete Template

Delete a template from a Clockify workspace using the deprecated template API.

Delete Time Entry

Tool to delete a time entry from a workspace by ID.

Delete User Group

Tool to delete a user group from a workspace.

Delete User Time Entries

Tool to delete multiple time entries for a user in a workspace.

Delete Webhook

Tool to delete a webhook from a workspace.

Duplicate Time Entry

Tool to duplicate an existing time entry in a Clockify workspace.

Filter Workspace Users

Tool to filter users in a workspace by advanced criteria.

Find User's Team Managers

Retrieves the list of team managers assigned to a specific user in a Clockify workspace.

Generate Detailed Report

Generates a detailed time-entry report with filtering and pagination for a workspace.

Generate Expense Report

Generate a detailed expense report for a workspace and date range, limited to 31 days on the free plan.

Generate New Webhook Token

Generate a new token for a workspace webhook, invalidating its previous token.

Generate Summary Report

Generate a workspace time-entry summary report grouped by projects, users, clients, or other criteria.

Generate Weekly Report

Generate a weekly workspace time-entry report with breakdowns grouped by user, project, task, or other dimensions.

Get All Addon Webhooks

Tool to list all webhooks for an addon in a workspace.

Get All My Workspaces

Lists workspaces accessible to the authenticated user, optionally filtered by roles.

Get All Webhooks

Tool to list all webhooks in a workspace.

Get Client By ID

Retrieves detailed information about a specific client in a Clockify workspace.

Get Clients

Tool to list clients in a workspace.

Get Created Entities

Retrieves created entities of a specified type in a workspace using the experimental API.

Get Currently Logged In User Info

Tool to retrieve info about the authenticated user.

Get Deleted Entities

Requests deleted entities of a specified type in a workspace through the experimental API.

Get Holidays

Tool to retrieve all holidays for a workspace.

Get Holidays In Period

Tool to retrieve holidays in a specific period.

Get In Progress Time Entries

Retrieve a page of currently running time entries in a workspace to check active timers and who is tracking time.

Get member's profile

Tool to get a member's profile in a workspace.

Get Project

Tool to retrieve detailed information about a specific project by ID.

Get Projects

Tool to list projects in a workspace with filtering and pagination.

Get Shared Report

Generate a shared report by ID using the Clockify Reports API.

Get Shared Reports

Retrieve the first page of shared reports for the current user in a Clockify workspace.

Get Tag By ID

Tool to retrieve detailed information about a specific tag by ID in a Clockify workspace.

Get Tags

List a page of workspace tags, optionally filtering by name or archived status.

Get Task

Retrieves detailed information about a specific task in a Clockify project.

Get Tasks

List, search, or filter a page of tasks on a specific project in a workspace.

Get Templates On Workspace

List a page of templates in a Clockify workspace, optionally filtered by name.

Get Time Entries

Tool to retrieve historical time entries for a user in a workspace with filters.

Get Time Entry

Tool to retrieve a specific time entry by ID from a workspace.

Get Updated Entities

Retrieve updated workspace entities using the experimental API for one supported type: time entries, time entry rates, time entry custom field values, or custom fields.

Get User Groups

List a page of user groups in a workspace.

Get Webhook By ID

Retrieves detailed information about a specific webhook in a Clockify workspace.

Get Webhook Logs

Tool to retrieve webhook logs for a specific webhook.

Get Workspace Info

Retrieves detailed information about a specific Clockify workspace.

List Assignments

Lists a page of scheduling assignments in a workspace, starting from a specified date and optionally bounded by an end date.

Remove User From Group

Remove a user from a Clockify user group.

Stop User Timer

Tool to stop a currently running timer for a user in a workspace.

Update Client

Updates a client in a Clockify workspace, including details such as name, email, address, or archived status.

Update Project

Tool to update an existing project in a Clockify workspace.

Update Project Memberships

Tool to update project memberships in Clockify.

Update Project User Hourly Rate

Tool to update a project user's billable rate.

Update Shared Report

Update a shared report's name, public visibility, and fixed-date setting in Clockify.

Update Tag

Tool to update a tag in a Clockify workspace.

Update Task

Tool to update an existing task on a project in Clockify.

Update Time Entries

Bulk updates multiple time entries for a specified user in a Clockify workspace, including start/end times, descriptions, billable status, and project or task associations.

Update Time Entry

Tool to update an existing time entry in a Clockify workspace.

Update User Group

Tool to update an existing user group in a workspace.

Update User Hourly Rate

Tool to update a user's hourly rate in a Clockify workspace.

Update Webhook

Updates a workspace webhook's configuration, including its name, URL, event type, and trigger sources.

Update Workspace Hourly Rate

Tool to update the workspace billable hourly rate.

FRAMEWORKS

How to build Clockify MCP Agent with another framework

Claude Code

Use Clockify MCP with Claude Code

Claude Cowork

Use Clockify MCP with Claude Cowork

OpenAI Agents SDK

Use Clockify MCP with OpenAI Agents SDK

Claude Agent SDK

Use Clockify MCP with Claude Agent SDK

Codex

Use Clockify MCP with Codex

OpenClaw

Use Clockify MCP with OpenClaw

Hermes

Use Clockify MCP with Hermes

Atomic Agent

Use Clockify MCP with Atomic Agent

LangChain

Use Clockify MCP with LangChain

Vercel AI SDK

Use Clockify MCP with Vercel AI SDK

Mastra AI

Use Clockify MCP with Mastra AI

LlamaIndex

Use Clockify MCP with LlamaIndex

CrewAI

Use Clockify MCP with CrewAI

Pydantic AI

Use Clockify MCP with Pydantic AI

AutoGen

Use Clockify MCP with AutoGen

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Google Sheets

Oauth2

Google Sheets is a cloud-based spreadsheet tool for real-time collaboration and data analysis. It lets teams work together from anywhere, updating information instantly.

Notion

Oauth2Api Key

Notion is a collaborative workspace for notes, docs, wikis, and tasks. It streamlines team knowledge, project tracking, and workflow customization in one place.

Airtable

Oauth2Api Key

Airtable combines the flexibility of spreadsheets with the power of a database for easy project and data management. Teams use Airtable to organize, track, and collaborate with custom views and automations.

Asana

Oauth2

Asana is a collaborative work management platform for teams to organize and track projects. It streamlines teamwork, boosts productivity, and keeps everyone aligned on goals.

FAQ

Frequently asked questions

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

Yes, you can. Google ADK 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 Clockify tools.

Yes, absolutely. You can configure which Clockify 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 Clockify data and credentials are handled as safely as possible.

Start with Clockify.It takes 30 seconds.

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

Start building

How to integrate Clockify MCP with Google ADK

Connect Clockify without auth hassles

Introduction

Also integrate Clockify with

TL;DR

What is Google ADK?

What is the Clockify MCP server, and what's possible with it?

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

How the Composio SDK works

Step-by-step Guide

Prerequisites

Getting API Keys for Google and Composio

Install dependencies

Set up ADK project

Set environment variables

Import modules and validate environment

Create Composio client and Tool Router session

Set up the McpToolset and create the Agent

Run the agent

Complete Code

Conclusion

Supported Tools

How to build Clockify MCP Agent with another framework

Claude Code

Claude Cowork

OpenAI Agents SDK

Claude Agent SDK

Codex

OpenClaw

Hermes

Atomic Agent

LangChain

Vercel AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

AutoGen

Explore Other Toolkits

Google Sheets

Notion

Airtable

Asana

Frequently asked questions

What are the differences in Tool Router MCP and Clockify MCP?

Can I use Tool Router MCP with Google ADK?

Can I manage the permissions and scopes for Clockify while using Tool Router?

How safe is my data with Composio Tool Router?

Start with Clockify.It takes 30 seconds.