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.

68 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_1_1_labelChanges dataCreate a new label for a 1 1. Required: label. Search labels first to avoid duplicates. API summary: Create a new tag.
create_1_1_propertyChanges dataCreate a new property for a 1 1. Required: day property. API summary: Create or update day properties.
create_1_1_stateChanges dataCreate a new state for a 1 1. Required: state.
create_1_1_teamChanges dataCreate a new team for a 1 1. Required: team. Search teams first to avoid duplicates. API summary: Team create.
create_1_1_userVisible to othersCreate a new user for a 1 1. Required: user. Search users first to avoid duplicates. Has effects visible outside this system. API summary: Invites user to the account.
create_1_1_webhookDeletesCreate a new webhook for a 1 1. Required: webhook. Destructive action; may require approval.
create_clientChanges dataCreate a client. Pass `client` with `name` and optional `color`, `active` and `external_references`.
create_eventVisible to othersCreate a new event. Has effects visible outside this system. API summary: Bulk import events (create/update/delete).
create_hourVisible to othersCreate a new hour. Has effects visible outside this system. API summary: Bulk import time entries (create/update/delete).
create_projectChanges dataCreate a project. Pass `project` with `name` and `rate_type`, plus optional `client_id`, `color`, `billable`, `hour_rate`, `budget` and `users`.
create_stateChanges dataCreate a new state. Required: state. API summary: Create time entry state.
create_state_permissionDeletesCreate a new permission for a state. Required: state permission. Destructive action; may require approval. API summary: Create or update state permissions.
create_taskChanges dataCreate a planned task (forecast). Pass `forecast` with `project_id`, `title`, `from`/`to` dates, `estimated_minutes` and `users`.
delete_1_1_forecastDeletesPermanently delete a forecast by forecast id. Destructive action; may require approval. API summary: Delete task.
delete_1_1_labelDeletesPermanently delete a label by label id. Destructive action; may require approval. API summary: Delete a tag.
delete_1_1_projectDeletesPermanently delete a project by project id. Destructive action; may require approval. API summary: Delete project.
delete_1_1_stateDeletesPermanently delete a state by state id. Destructive action; may require approval.
delete_1_1_teamDeletesPermanently delete a team by team id. Destructive action; may require approval. API summary: Team delete.
delete_1_1_userDeletesPermanently delete a user by user id. Destructive action; may require approval. API summary: Delete user.
delete_1_1_webhookDeletesPermanently delete a webhook by webhook id. Destructive action; may require approval. API summary: Delete webhook.
delete_stateDeletesPermanently delete a state by state id. Destructive action; may require approval. API summary: Delete time entry state.
delete_state_permissionDeletesPermanently delete a permission by permission id. Destructive action; may require approval. API summary: Delete state permissions.
delete_time_entryDeletesPermanently delete a time entry by `hour_id`. This cannot be undone.
get_1_1_forecastGet one forecast for a 1 1 by forecast id. API summary: Show task.
get_1_1_labelGet one label for a 1 1 by label id. API summary: Get a single tag.
get_1_1_teamGet one team for a 1 1 by team id. API summary: Team details.
get_1_1_userGet one user for a 1 1 by user id. API summary: Get user details.
get_1_1_webhookGet one webhook for a 1 1 by webhook id. API summary: Show webhook.
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_1_1_propertiesList properties for a 1 1. Optional filters: since, until or dates. API summary: List day properties.
list_1_1_rolesList roles for a 1 1. API summary: List all roles.
list_1_1_statesList states for a 1 1. API summary: List all states.
list_1_1_webhooksList webhooks for a 1 1. Results are paginated. API summary: List all webhooks.
list_clientsList clients. Use `show` (e.g. active, all) and `limit`/`offset` to page.
list_compliancesList compliances. Optional filters: from or to. API summary: List per-user compliance metrics.
list_forecast_summariesList summaries for a forecast. Optional filters: since, until, completed, user ids, project ids or forecast ids. API summary: Task summaries.
list_labelsList labels (tags) used on time entries and projects. Use `filter`, `parent_id` and `limit`/`offset`.
list_permissionsList permissions. API summary: List current user permissions.
list_projectsList projects, filtered by `filter` (e.g. active, archived), `project_ids` or `updated_after`. Page with `limit` and `offset`.
list_statesList states. API summary: List time entry states.
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_user_permissionsList permissions for a user. API summary: List a user's permissions.
list_usersList users in the Timely account. Use `filter` (e.g. active) and `limit`/`offset` to page.
list_users_2List users for a user. API summary: List a user's capacities.
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`.
search_teamsSearch teams by q. Use this to find existing teams before creating a new team. Results are paginated.
search_usersSearch users by q. Use this to find existing users before creating a new user. Results are paginated.
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_1_1_labelChanges dataUpdate an existing label identified by label id. API summary: Update a tag.
update_1_1_propertiesVisible to othersUpdate an existing property identified by account id. Has effects visible outside this system. API summary: Update day properties.
update_1_1_stateChanges dataUpdate an existing state identified by state id. API summary: Update a state.
update_1_1_teamChanges dataUpdate an existing team identified by team id. Only the fields you pass are changed. API summary: Team patch.
update_1_1_userChanges dataUpdate an existing user identified by user id. API summary: Update user.
update_1_1_webhookDeletesUpdate an existing webhook identified by webhook id. Destructive action; may require approval. API summary: Update webhook.
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_stateChanges dataUpdate an existing state identified by state id. API summary: Update time entry state.
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 HeyMyApps 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://heymyapps.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 HeyMyApps 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 HeyMyApps Pro plan. HeyMyApps 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 HeyMyApps needs an application in your Timely account to sign in with. You create it under oauth_applications with the redirect URI https://heymyapps.com/oauth/callback, paste the Client ID and Secret, and sign in once. The application stays in your account, so you control it.