Integration · Productivity

Connect Claude & ChatGPT to Timely

Ask your AI how many hours went into a project this month, to log two hours on a client, or to plan a task for a colleague in Timely. It can list and log time entries, run grouped time reports, manage projects, clients and planned tasks, and see users, teams and capacity. Timesheet questions get answered without building a report by hand.

Connect Timely free

Free plan, no credit card. Takes about a minute.

Try asking

“Log 2 hours on the Website project today with the note 'homepage review'.”
The AI finds the project and logs a time entry for today with the duration and note.
“How many hours did the team log per project last month?”
It runs a time report for the period, grouped by project.
“Which hours did Anna log this week?”
It lists Anna's time entries for the week with projects, durations and notes.

What your AI can do

Time entries and timers

List, log, update and delete time entries, and start or stop the timer on an entry.

Reports

Get time reports for a period, filtered by users, projects, clients, labels, teams or billed status and grouped the way you need.

Projects and planning

Create and update projects and clients, plan and complete tasks, and see users, teams, labels and capacity.

“What is the budget and hourly rate on project Nordic Rebrand?”
It reads the project with its client, budget, rate and labels.
“Plan a 4 hour task for Jonas on the Website project next Monday.”
It creates a planned task on the project for Jonas with the dates and estimated time.
“Who has spare capacity next week?”
It lists users' working capacity for the week, so you can compare it with planned work.

25 tools for Timely

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

create_clientChanges dataCreate a client. Pass `client` with `name` and optional `color`, `active` and `external_references`.
create_projectChanges dataCreate a project. Pass `project` with `name` and `rate_type`, plus optional `client_id`, `color`, `billable`, `hour_rate`, `budget` and `users`.
create_taskChanges dataCreate a planned task (forecast). Pass `forecast` with `project_id`, `title`, `from`/`to` dates, `estimated_minutes` and `users`.
delete_time_entryDeletesPermanently delete a time entry by `hour_id`. This cannot be undone.
get_clientGet one client by `customer_id`.
get_current_userGet the signed-in Timely user, with their ID and role.
get_filtered_reportGet a grouped time report between `since` and `until`, filtered by users, projects, clients, labels, teams, states or `billed`, and grouped with `group_by`.
get_projectGet one project by `project_id`, with client, budget, rate and labels.
get_time_entryGet one time entry by `hour_id`.
get_time_reportGet a time report between `since` and `until`, optionally for specific `user_ids`, `project_ids` or `client_ids`.
list_clientsList clients. Use `show` (e.g. active, all) and `limit`/`offset` to page.
list_labelsList labels (tags) used on time entries and projects. Use `filter`, `parent_id` and `limit`/`offset`.
list_projectsList projects, filtered by `filter` (e.g. active, archived), `project_ids` or `updated_after`. Page with `limit` and `offset`.
list_tasksList planned tasks (forecasts), filtered by `user_ids`, `project_ids`, `since`/`upto` or `completed`.
list_teamsList teams in the account.
list_time_entriesList logged time entries, filtered by `since`/`upto` dates, `day`, `user_id`, `project_id` or `hour_ids`. Paginate with `page` and `limit`.
list_user_capacitiesList users' working capacity between `since` and `until`, optionally for specific `user_ids`.
list_usersList users in the Timely account. Use `filter` (e.g. active) and `limit`/`offset` to page.
log_timeChanges dataLog time. Pass `event` with `project_id`, `day` (YYYY-MM-DD) and the duration as `hours`/`minutes`, plus optional `note`, `from`/`to`, `label_ids`, `billable` and `user_id`.
start_timerVisible to othersStart the timer on an existing time entry by `hour_id`.
stop_timerVisible to othersStop the running timer on a time entry by `hour_id`.
update_clientChanges dataUpdate a client by `customer_id`. Pass `client` with the fields to change.
update_projectChanges dataUpdate a project by `project_id`. Pass `project` with the fields to change.
update_taskChanges dataUpdate a planned task (forecast) by `forecast_id`. Pass `forecast` with the fields to change, e.g. completed_at to mark it done.
update_time_entryChanges dataUpdate a time entry by `hour_id`. Pass `event` with the fields to change, such as hours, minutes, note, project_id or day.

Set up in three steps

1
Pick the app
Create a free PipMCP account and choose Timely from the app list.
2
Paste your key
Create your own OAuth application in Timely, paste its Client ID and Secret with your account ID, then sign in with Timely once. You need admin access. Open https://app.timelyapp.com/{your account ID}/oauth_applications (the account ID is the number right after app.timelyapp.com/ in your browser), create an OAuth application with the redirect URI https://pipmcp.com/oauth/callback, and copy the Client ID and Secret.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Timely?

It can list and read time entries, users, projects, clients, labels, teams, planned tasks and capacity, and run time reports. It can log, update and delete time entries, start and stop timers, create and update projects and clients, and create and update planned tasks.

Does the AI see my Timely credentials?

No. Your Timely credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with reports only. Deleting a time entry is permanent, and starting or stopping timers changes what your team sees, so these can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT, open Settings › Apps & Connectors › Advanced, turn on Developer mode and add your PipMCP link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

Timely connects with OAuth, and this OAuth connection needs the PipMCP Pro plan. PipMCP also has a free plan with no credit card, but it does not include this connection. Paid plans bill per completed task. You also need your own Timely account.

Why do I create my own OAuth application?

Timely connects through OAuth, so PipMCP needs an application in your Timely account to sign in with. You create it under oauth_applications with the redirect URI https://pipmcp.com/oauth/callback, paste the Client ID and Secret, and sign in once. The application stays in your account, so you control it.