How to integrate Timely MCP with OpenClaw

Trusted by
AWS
Glean
Zoom
Airtable
GET STARTED FOR FREEGET A DEMO

30 min · no commitment · see it on your stack

Timely logo
OpenClaw logo
divider

Introduction

OpenClaw is the fastest growing agent harness out there, which can work 24/7 to automate almost any kind of tasks. However, its capabilities are limited to the tools it has access to. Composio allows your OpenClaw to access Timely with authentication management handled for you. You can execute actions on Timely via your favorite OpenClaw interface (Telegram, WhatsApp, TUI, etc), whichever you prefer.

Also integrate Timely with

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • Programmatic tool calling allows LLMs to write its code in a remote workbench to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Handling Large tool responses out of LLM context to minimize context rot.
  • Dynamic just-in-time access to 20,000 tools across 1000+ other Apps for cross-app workflows. It loads the tools you need, so LLMs aren't overwhelmed by tools you don't need.

How to install Timely with OpenClaw

Using Composio API Key and Setup Prompt

Copy the setup prompt from the OpenClaw dashboard
  • Run it in your OpenClaw chat interface.
  • Authenticate Timely from the dashboard
  • Go back to your OpenClaw interface and start asking questions.

Using OpenClaw/Composio Plugin

1. Install OpenClaw Composio plugin

bash
openclaw plugins install @composio/openclaw-plugin

2. Copy the API Key from dashboard.composio.dev

3. Setup OpenClaw Config

bash
openclaw config set plugins.entries.composio.config.consumerKey "ck_your_key_here"

4. Restart OpenClaw

bash
openclaw gateway restart

5. Go to your chat interface and start asking questions.

6. When prompted, authenticate the app and you're all set.

How It Works

The plugin connects to Composio's MCP server at https://connect.composio.dev/mcp and registers all available tools directly into the OpenClaw agent. Tools are called by name — no extra search or execute steps needed.

If a tool returns an auth error, the agent will prompt you to connect that toolkit at dashboard.composio.dev.

Configuration

bash
{
  "plugins": {
    "entries": {
      "composio": {
        "enabled": true,
        "config": {
          "consumerKey": "ck_your_key_here"
        }
      }
    }
  }
}
OptionDescriptionDefault
enabledEnable or disable the plugintrue
consumerKeyYour Composio consumer key (ck_...)—
mcpUrlMCP server URL (advanced)https://connect.composio.dev/mcp

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

The Timely MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Timely account. It provides structured and secure access to your time-tracking data, so your agent can perform actions like retrieving account information, managing webhooks, and integrating time logs with other workflows on your behalf.

  • Account information retrieval: Instantly fetch up-to-date details about your Timely account, including billing, activity, and user info, for streamlined reporting or troubleshooting.
  • Automated webhook setup: Direct your agent to create new webhooks for your account, enabling real-time integration with external apps and automated event notifications.
  • Seamless workflow automation: Connect Timely events to other services or agents by configuring webhooks, so you can automate time-tracking updates or project triggers.
  • Centralized time management: Allow your agent to coordinate between Timely and your other productivity tools by securely accessing and sharing account data as needed.

Supported Tools & Triggers

Tools
Create ClientTool to create a new client in the specified Timely account.
Create Day LockingTool to create a day locking entry that prevents editing of time entries for specific dates and users.
Create LabelTool to create a new label in the specified Timely account.
Create reportTool to generate reports for a Timely account with optional filters.
Create TeamTool to create a new team in the specified Timely account.
Create WebhookTool to create a new webhook for the specified account.
Delete a labelTool to delete a label by ID from a Timely account.
Delete a teamTool to delete a team by its ID.
Delete WebhookTool to delete an existing webhook by its ID.
Filter reportsTool to filter Timely reports based on date range, users, projects, labels, teams, and billing status.
Get activitiesTool to retrieve all activities (audit trail) for a Timely account.
Get ClientTool to retrieve details of a specific client by its ID.
Get current user's permissionsTool to retrieve the current user's permissions for a specified account.
Get current userTool to retrieve the currently authenticated user.
Retrieve a labelTool to retrieve a label by ID from a Timely account.
Get projectTool to retrieve a single project by its ID.
Retrieve a teamTool to retrieve details of a specific team by its ID.
Retrieve a userTool to retrieve a user by ID from a Timely account.
Get user capacitiesTool to retrieve capacity information for a specific user in a Timely account.
Get user permissionsTool to retrieve a user's permissions by their ID.
Get WebhookTool to retrieve a specific webhook by its ID.
List accountsRetrieve all accessible Timely accounts for the authenticated user.
List clientsTool to list all clients in a Timely account with optional filtering and sorting.
List eventsTool to list all events (time entries) in a Timely account with optional filtering by date range, users, and projects.
List forecastsTool to list all forecasts (tasks) in a Timely account with optional date filtering.
List labelsTool to list all labels in a Timely account.
List project eventsTool to list all events (time entries) for a specific project in Timely.
List projectsTool to list all projects in a Timely account with optional filtering and sorting.
List rolesTool to list all available roles in a Timely account.
List teamsTool to list all teams in the specified Timely account.
List user eventsTool to list all events (time entries) for a specific user in Timely.
List usersTool to list all users in a Timely account with optional filtering and pagination.
List WebhooksTool to list all webhooks in the specified account.
Process bulk eventsTool to create, update, or delete multiple events in a single bulk operation.
Retrieve an accountTool to retrieve details of a specific account by its ID.
Update a clientTool to update an existing client by ID in Timely.
Update day locking settingsTool to update day locking settings for specified users and dates.
Update a labelTool to update a label by ID in a Timely account.
Update a projectTool to update a project by ID in a Timely account.
Update a userTool to update a user by ID in a Timely account.
Update WebhookTool to update an existing webhook by ID.

Conclusion

You've successfully integrated Timely with OpenClaw using Composio plugin. Now interact with Timely directly from your terminal, Web UI, or any messenger app using natural language commands.

Key benefits of this setup:

  • Seamless integration across TUI, Web UIs, and Messenger apps like Telegram, WhatsApp, Slack, etc.
  • Natural language commands for Timely operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1000+ apps for cross-app workflows
  • Programmatic tool calling for complex tool chaining

Next steps:

  • Try asking OpenClaw to perform various Timely operations
  • Explore cross-app workflows by connecting more toolkits like Calendar, Slack, Notion, etc.
  • Build complex automation scripts that leverage OpenClaw's 24/7 running capabilities

How to build Timely MCP Agent with another framework

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Timely MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Timely MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use Timely MCP with Claude Code

Claude Cowork logo

Claude Cowork

Use Timely MCP with Claude Cowork

Codex logo

Codex

Use Timely MCP with Codex

Hermes logo

Hermes

Use Timely MCP with Hermes

CLI logo

CLI

Use Timely MCP with CLI

Google ADK logo

Google ADK

Use Timely MCP with Google ADK

LangChain logo

LangChain

Use Timely MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Timely MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Timely MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Timely MCP with LlamaIndex

CrewAI logo

CrewAI

Use Timely MCP with CrewAI

FAQ

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

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

Can I use Tool Router MCP with OpenClaw?

Yes, you can. OpenClaw 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 Timely tools.

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

Yes, absolutely. You can configure which Timely 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.

How safe is my data with Composio Tool Router?

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 Timely data and credentials are handled as safely as possible.

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Get started for freeGet a demo↗