How to integrate Timely MCP with OpenClaw

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.

Timely logoTimely
Oauth2

Timely is an automatic time-tracking platform that seamlessly records work across apps, calendars, and devices. It helps you create detailed timesheets and gain productivity insights without manual input.

41 Tools

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.

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
TOOLS

Supported Tools

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

Create Client

Tool to create a new client in the specified Timely account.

Create Day Locking

Tool to create a day locking entry that prevents editing of time entries for specific dates and users.

Create Label

Tool to create a new label in the specified Timely account.

Create report

Tool to generate reports for a Timely account with optional filters.

Create Team

Tool to create a new team in the specified Timely account.

Create Webhook

Tool to create a new webhook for the specified account.

Delete a label

Tool to delete a label by ID from a Timely account.

Delete a team

Tool to delete a team by its ID.

Delete Webhook

Tool to delete an existing webhook by its ID.

Filter reports

Tool to filter Timely reports based on date range, users, projects, labels, teams, and billing status.

Get activities

Tool to retrieve all activities (audit trail) for a Timely account.

Get Client

Tool to retrieve details of a specific client by its ID.

Get current user's permissions

Tool to retrieve the current user's permissions for a specified account.

Get current user

Tool to retrieve the currently authenticated user.

Retrieve a label

Tool to retrieve a label by ID from a Timely account.

Get project

Tool to retrieve a single project by its ID.

Retrieve a team

Tool to retrieve details of a specific team by its ID.

Retrieve a user

Tool to retrieve a user by ID from a Timely account.

Get user capacities

Tool to retrieve capacity information for a specific user in a Timely account.

Get user permissions

Tool to retrieve a user's permissions by their ID.

Get Webhook

Tool to retrieve a specific webhook by its ID.

List accounts

Retrieve all accessible Timely accounts for the authenticated user.

List clients

Tool to list all clients in a Timely account with optional filtering and sorting.

List events

Tool to list all events (time entries) in a Timely account with optional filtering by date range, users, and projects.

List forecasts

Tool to list all forecasts (tasks) in a Timely account with optional date filtering.

List labels

Tool to list all labels in a Timely account.

List project events

Tool to list all events (time entries) for a specific project in Timely.

List projects

Tool to list all projects in a Timely account with optional filtering and sorting.

List roles

Tool to list all available roles in a Timely account.

List teams

Tool to list all teams in the specified Timely account.

List user events

Tool to list all events (time entries) for a specific user in Timely.

List users

Tool to list all users in a Timely account with optional filtering and pagination.

List Webhooks

Tool to list all webhooks in the specified account.

Process bulk events

Tool to create, update, or delete multiple events in a single bulk operation.

Retrieve an account

Tool to retrieve details of a specific account by its ID.

Update a client

Tool to update an existing client by ID in Timely.

Update day locking settings

Tool to update day locking settings for specified users and dates.

Update a label

Tool to update a label by ID in a Timely account.

Update a project

Tool to update a project by ID in a Timely account.

Update a user

Tool to update a user by ID in a Timely account.

Update Webhook

Tool to update an existing webhook by ID.

FAQ

Frequently asked questions

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.

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.

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.

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.

Start with Timely.It takes 30 seconds.

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

Start building