Integration · Projects & tasks

Connect Claude & ChatGPT to Runn

Ask your AI who is booked on a project, what someone is working on next month, or how a project's actual hours compare to its schedule in Runn. It can create projects, clients and people, schedule assignments, log time, add leave, notes and milestones, and update projects and people. Resource planning questions get answered without opening the planner.

Connect Runn free

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

Try asking

“What is Sara scheduled on in October?”
The AI finds Sara and lists her assignments in that date range, with project, role and minutes per day.
“Is Jonas on leave next week?”
It lists his leave entries for that date range.
“Book Sara on the Website Relaunch project as designer, 4 hours a day from 3 to 14 November.”
It finds the person, project and role, then creates the assignment with 240 minutes per day.

What your AI can do

People and assignments

List and update people, schedule them on projects with role and minutes per day, add leave and delete assignments.

Projects and clients

Create and update projects and clients, read project totals, phases and milestones, and add notes and milestones.

Time and actuals

Log billable and non-billable time, and list actuals and assignments by person, project, role and date range.

“How is the Website Relaunch project tracking?”
It reads the project totals: scheduled and actual hours, revenue and cost.
“Log 6 billable hours for Jonas on Acme Portal yesterday.”
It adds 360 billable minutes for that date. The minutes are added to any time already logged that day.
“Add a milestone 'Go live' on 1 December to Acme Portal.”
It creates the milestone on the project with title and date.

189 tools for Runn

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

add_a_project_tag_to_a_projectChanges dataUpdate an existing project identified by project id. API summary: Add a project tag to a project.
add_a_workstream_to_a_projectChanges dataUpdate an existing project identified by workstream id. API summary: Add a workstream to a project.
add_project_noteChanges dataAdd a note to a project by `project_id`.
add_time_entryChanges dataLog time a person worked on a project on one `date`: `person_id`, `project_id`, `role_id`, `billable_minutes` and `nonbillable_minutes`. The minutes are added to any existing actual for that day.
create_a_phase_for_a_projectChanges dataCreate a new project for a project. Required: accept version, name, start date, end date or color. Search projects first to avoid duplicates. API summary: Create a phase for a project.
create_a_project_budget_roleDeletesCreate a new project for a project. Required: accept version or role id. Search projects first to avoid duplicates. Destructive action; may require approval. API summary: Create a project budget role.
create_actualChanges dataCreate a new actual. Required: accept version, date, billable minutes, nonbillable minutes, person id or project id. API summary: Create or overwrite an actual.
create_an_other_expense_for_a_projectChanges dataCreate a new project for a project. Required: accept version, cost, charge, name or date. Search projects first to avoid duplicates. API summary: Create an other expense for a project.
create_assignmentChanges dataSchedule a person on a project: `person_id`, `project_id`, `role_id`, `start_date`, `end_date` and `minutes_per_day`.
create_bulkVisible to othersCreate a new bulk. Required: accept version or actuals. Has effects visible outside this system. API summary: Create or overwrite actuals in bulk.
create_checkboxChanges dataCreate a new checkbox. Required: accept version, name, model, required, show in planner or filterable in planner. API summary: Create a checkbox custom field.
create_clientChanges dataCreate a client with a `name` and optional website.
create_clients_in_bulkVisible to othersCreate a new bulk. Required: accept version or clients. Has effects visible outside this system. API summary: Create clients in bulk.
create_contact_contractChanges dataCreate a new contract for a contact. Required: accept version or role id. API summary: Add a new contract to a person.
create_contact_projectChanges dataCreate a new project for a contact. Required: accept version, project id or role id. Search projects first to avoid duplicates. API summary: Add project to a person or placeholder.
create_contact_skillChanges dataCreate a new skill for a contact. Required: accept version or skill id. API summary: Add a skill to a person or placeholder.
create_dateChanges dataCreate a new date. Required: accept version, name, model, required, show in planner or filterable in planner. API summary: Create a date custom field.
create_invitationChanges dataCreate a new invitation. Required: accept version, email, user type, financial permission or from user. API summary: Create an invitation for a user.
create_leaveChanges dataAdd leave for a person by `person_id` from `start_date` to `end_date`, with an optional note and `minutes_per_day`.
create_leave_time_offs_in_bulkVisible to othersCreate a new bulk. Required: accept version or time offs. Has effects visible outside this system. API summary: Create leave time offs in bulk.
create_people_tagChanges dataCreate a new people tag. Required: accept version or name. API summary: Create a people tag.
create_personChanges dataAdd a person with first and last name, `role_id`, and optionally email, team, start date, cost per hour and employment details.
create_placeholderChanges dataCreate a new placeholder. Required: accept version or role id. API summary: Create a placeholder.
create_placeholder_skillChanges dataCreate a new skill for a placeholder. Required: accept version or skill id. API summary: Add a skill to a placeholder.
create_placeholder_teamChanges dataCreate a new team for a placeholder. Required: accept version or team id. API summary: Add a placeholder to a team.
create_projectChanges dataCreate a project. Pass the project fields in `body`, such as name and client ID.
create_project_2Changes dataCreate a new project. Required: accept version or name. Search projects first to avoid duplicates. API summary: Create a project tag.
create_project_milestoneChanges dataAdd a milestone to a project by `project_id` with a `title`, `date` and `icon`.
create_project_person_requestChanges dataCreate a new person request for a project. Required: accept version, person id or status. API summary: Create a person request on a project.
create_rate_cardChanges dataCreate a new rate card. Required: accept version, name, description, references, is blended rate card or blended rate. API summary: Create a rate card.
create_roleDeletesCreate a new role. Required: accept version or name. Search roles first to avoid duplicates. Destructive action; may require approval. API summary: Create a role.
create_selectChanges dataCreate a new select. Required: accept version, name, model, options, single select or required. API summary: Create a select custom field.
create_select_optionChanges dataCreate a new option for a select. Required: accept version or name. API summary: Create a select custom field option.
create_skillChanges dataCreate a new skill. Required: accept version or name. API summary: Create a skill.
create_skill_contactChanges dataCreate a new contact for a skill. Required: accept version or people. Search contacts first to avoid duplicates. API summary: Add people to a skill.
create_teamChanges dataCreate a new team. Required: accept version or name. API summary: Create a team.
create_textChanges dataCreate a new text. Required: accept version, name, model, required, show in planner or filterable in planner. API summary: Create a text custom field.
create_workstreamChanges dataCreate a new workstream. Required: accept version or name. API summary: Create a workstream.
delete_a_phase_for_a_projectDeletesPermanently delete a project by project id 2. Destructive action; may require approval. API summary: Delete a phase for a project.
delete_a_projectDeletesPermanently delete a project by project id. Destructive action; may require approval.
delete_a_project_budget_roleDeletesPermanently delete a project by role id. Destructive action; may require approval. API summary: Delete a project budget role.
delete_actualDeletesPermanently delete a actual by actual id. Destructive action; may require approval. API summary: Delete a specific actual.
delete_assignmentDeletesPermanently delete an assignment by `assignment_id`. This cannot be undone.
delete_bulksMoves moneyPermanently delete a bulk. Financial or irreversible action; may require approval. API summary: Delete leave time offs in bulk.
delete_checkboxDeletesPermanently delete a checkbox by checkbox field id. Destructive action; may require approval. API summary: Delete a checkbox custom field.
delete_contactDeletesPermanently delete a contact by contact id. Destructive action; may require approval. API summary: Delete a person or placeholder.
delete_contact_contractDeletesPermanently delete a contract by contract id. Destructive action; may require approval. API summary: Delete a contract for a person.
delete_contact_skillDeletesPermanently delete a skill by skill id. Destructive action; may require approval. API summary: Remove a skill from a person or placeholder.
delete_dateDeletesPermanently delete a date by date field id. Destructive action; may require approval. API summary: Delete a date custom field.
delete_invitationDeletesPermanently delete a invitation by invitation id. Destructive action; may require approval. API summary: Delete an invitation.
delete_leaveDeletesPermanently delete a leave by time off id. Destructive action; may require approval. API summary: Delete a leave time off.
delete_people_tagDeletesPermanently delete a people tag by people tag id. Destructive action; may require approval.
delete_placeholder_skillDeletesPermanently delete a skill by skill id. Destructive action; may require approval. API summary: Remove a skill from a placeholder.
delete_placeholder_teamDeletesPermanently delete a team by team id. Destructive action; may require approval. API summary: Remove a placeholder from a team.
delete_projectDeletesPermanently delete a project by project id. Destructive action; may require approval. API summary: Remove a project tag from a project.
delete_project_milestoneDeletesPermanently delete a milestone by milestone id. Destructive action; may require approval. API summary: Delete a milestone for a project.
delete_project_workstreamDeletesPermanently delete a project by workstream id. Destructive action; may require approval. API summary: Delete project workstream.
delete_rate_cardDeletesPermanently delete a rate card by rate card id. Destructive action; may require approval.
delete_rostered_offDeletesPermanently delete a rostered off by time off id. Destructive action; may require approval. API summary: Delete a rostered time off.
delete_selectDeletesPermanently delete a select by select field id. Destructive action; may require approval. API summary: Delete a select custom field.
delete_select_optionDeletesPermanently delete a option by select option id. Destructive action; may require approval. API summary: Delete a select custom field option.
delete_skillDeletesPermanently delete a skill by skill id. Destructive action; may require approval.
delete_teamDeletesPermanently delete a team by team id. Destructive action; may require approval.
delete_textDeletesPermanently delete a text by text field id. Destructive action; may require approval. API summary: Delete a text custom field.
delete_userDeletesPermanently delete a user by user id. Destructive action; may require approval.
delete_user_viewDeletesPermanently delete a view by view id. Destructive action; may require approval. API summary: Remove allocated view from user.
delete_workstreamDeletesPermanently delete a workstream by workstream id. Destructive action; may require approval.
get_a_project_budget_roleGet one project for a project by role id. API summary: Get a project budget role.
get_clientGet one client by `customer_id` (the client ID).
get_contact_get_person_hours_reportGet one contact by contact id. Results are paginated. API summary: Get by-day entries for a person with assignments and actuals.
get_contact_get_person_reportGet one contact by contact id. API summary: Show metrics (beta).
get_holiday_groupGet one holiday group by holiday group id. API summary: Show a holiday group.
get_leaveGet one leave by time off id. API summary: Show a leave time off.
get_legacy_idGet one legacy id by legacy id. API summary: Convert a legacy ID from API v0 to a new ID.
get_meGet the Runn account and user the API token belongs to.
get_people_tagGet one people tag by people tag id. API summary: Show a people tag.
get_personGet one person by `contact_id` (the person ID), including role, team and tags.
get_projectGet one project by `project_id`, including client, budget, pricing model and dates.
get_project_2Get one project by project id. API summary: Show a project tag.
get_project_get_project_hours_reportGet one project by project id. Results are paginated. API summary: Get by-day entries for a project with assignments and actuals.
get_project_get_project_phaseGet one project for a project by project id 2. API summary: Show a phase for a project.
get_project_get_project_reportGet one project by project id. API summary: Show metrics (beta).
get_project_get_project_workstreamGet one project for a project by workstream id. API summary: View project workstream.
get_project_person_requestGet one person request for a project by person request id. API summary: Show a single person request for a project.
get_project_totalsGet the totals for a project by `project_id`: scheduled and actual hours, revenue and cost.
get_rate_cardGet one rate card by rate card id. API summary: Show a rate card.
get_roleGet one role by role id. API summary: Show a role.
get_skillGet one skill by skill id. API summary: Show a skill.
get_teamGet one team by team id. API summary: Show a team.
get_userGet one user by user id. API summary: Show a user.
get_workstreamGet one workstream by workstream id. API summary: Show a workstream.
list_activity_logsList activity logs. Optional filters: event type, occurred after or order by. Results are paginated. API summary: List events.
list_actualsList actuals (time actually worked), filtered by `person_id`, `project_id`, `role_id` and a `min_date` to `max_date` range.
list_assignmentsList assignments (scheduled work), filtered by `person_id`, `project_id`, `role_id` and a `start_date` to `end_date` range.
list_budget_rolesList budget roles. Optional filters: modified after. Results are paginated.
list_checkboxesList checkboxes. Optional filters: model. Results are paginated. API summary: List checkbox custom fields.
list_clientsList clients, optionally filtered by `name`.
list_contact_actualsList actuals for a contact. Optional filters: project id, role id or modified after. Results are paginated. API summary: List actuals for a person.
list_contact_assignmentsList assignments for a contact. Optional filters: project id, role id, start date, end date or modified after. Results are paginated. API summary: List assignments for a person or placeholder.
list_contact_contractsList contracts for a contact. Results are paginated. API summary: List contracts for a person.
list_contact_projectsList projects for a contact. Results are paginated. API summary: List projects for a person or placeholder.
list_contact_skillsList skills for a contact. Optional filters: modified after. Results are paginated. API summary: List skills for a person or placeholder.
list_contractsList contracts. Optional filters: modified after, sort by or order. Results are paginated.
list_currentsList currents. Optional filters: modified after. Results are paginated. API summary: List people current contracts.
list_currents_get_person_current_contractList currents. API summary: Show current contract for a person.
list_custom_fieldsList custom fields. Optional filters: modified after. Results are paginated. API summary: List people custom fields.
list_customer_projectsList projects for a customer. Optional filters: include archived or modified after. Results are paginated. API summary: List a client's projects.
list_datesList dates. Optional filters: model. Results are paginated. API summary: List date custom fields.
list_holiday_group_holidaysList holidays for a holiday group. Results are paginated. API summary: Show holidays for a holiday group.
list_holiday_groupsList holiday groups. Optional filters: sort by or order. Results are paginated.
list_holiday_time_offsList holidays. Optional filters: sort by, order, person id or modified after. Results are paginated. API summary: List holiday time offs.
list_holidaysList holidays. Results are paginated. API summary: List holidays for a person.
list_invitationsList invitations. Optional filters: sort by or order. Results are paginated.
list_leaveList leave (time off) entries, filtered by `person_id` and a `start_date` to `end_date` range.
list_leavesList leaves. Results are paginated. API summary: List leave for a person.
list_messagesList messages. Optional filters: modified after. Results are paginated. API summary: List people notes.
list_milestonesList milestones. Optional filters: modified after. Results are paginated. API summary: List project milestones.
list_other_expensesList other expenses. Optional filters: modified after. Results are paginated.
list_other_expenses_for_a_projectList projects for a project. Results are paginated. API summary: List other expenses for a project.
list_peopleList people, filtered by `first_name`, `last_name`, `email` or `external_id`.
list_people_tagsList people tags. Optional filters: sort by, order or modified after. Results are paginated.
list_person_requestsList person requests. Optional filters: modified after. Results are paginated.
list_phasesList phases. Optional filters: modified after. Results are paginated.
list_placeholdersList placeholders. Optional filters: sort by, order or modified after. Results are paginated.
list_project_actualsList actuals for a project. Optional filters: person id, role id or modified after. Results are paginated.
list_project_assignmentsList assignments for a project. Optional filters: person id, role id, start date, end date or modified after. Results are paginated.
list_project_contactsList contacts for a project. Optional filters: include archived. Results are paginated. API summary: List people assigned to a project.
list_project_custom_fieldsList custom fields. Optional filters: modified after. Results are paginated. API summary: List project custom fields.
list_project_messagesList messages for a project. Results are paginated. API summary: List notes for a project.
list_project_milestonesList the milestones of a project by `project_id`.
list_project_notesList messages. Optional filters: modified after. Results are paginated. API summary: List project notes.
list_project_person_requestsList person requests for a project. Results are paginated. API summary: List the person requests for a project.
list_project_phasesList the phases of a project by `project_id`.
list_project_ratesList project rates. Optional filters: modified after. Results are paginated. API summary: List role rates.
list_project_timesheet_locksList timesheet locks for a project. API summary: Show a timesheet lock for a project.
list_project_workstreamsList project workstreams. Optional filters: modified after. Results are paginated.
list_projectsList projects, optionally filtered by `name` (partial match) or `external_id`. Set `include_archived` to include archived projects.
list_projects_2List projects. Optional filters: sort by, order, include archived or modified after. Results are paginated. API summary: List project tags.
list_projects_list_project_budget_rolesList projects for a project. Results are paginated. API summary: Get a paginated list of project budget roles for a project.
list_rate_cardsList rate cards. Optional filters: sort by, order or modified after. Results are paginated.
list_role_rates_for_a_projectList projects for a project. Results are paginated. API summary: List role rates for a project.
list_rolesList roles, optionally filtered by `name`. Use this to find a role ID.
list_rostered_offsList rostered offs. Results are paginated. API summary: List rostered time offs for a person.
list_rostered_time_offsList rostered offs. Optional filters: sort by, order, person id or modified after. Results are paginated. API summary: List rostered time offs.
list_selectsList selects. Optional filters: model. Results are paginated. API summary: Show a select custom field.
list_skill_contactsList contacts for a skill. Results are paginated. API summary: List people for a skill.
list_skillsList the skills defined in Runn.
list_skills_2List skills. Optional filters: include placeholders or modified after. Results are paginated. API summary: List people skills.
list_team_contactsList contacts for a team. Results are paginated. API summary: List people in a team.
list_teamsList teams. Use this to find a team ID.
list_textsList texts. Optional filters: model. Results are paginated. API summary: Show a text custom field.
list_totals_for_projects_with_assignments_and_actualsList projects. Optional filters: include archived. Results are paginated. API summary: List totals for projects with assignments and actuals.
list_user_viewsList views for a user. Results are paginated. API summary: List allocated views for a user.
list_usersList users. Optional filters: modified after. Results are paginated. API summary: List members of projects.
list_users_list_usersList users. Optional filters: modified after. Results are paginated.
list_viewsList views. Optional filters: modified after. Results are paginated.
list_workstreamsList workstreams. Optional filters: sort by, order or modified after. Results are paginated.
list_workstreams_assigned_to_a_projectList projects for a project. Optional filters: include archived. Results are paginated. API summary: List workstreams assigned to a project.
update_a_phase_for_a_projectChanges dataUpdate an existing project identified by project id 2. Only the fields you pass are changed. API summary: Update a phase for a project.
update_a_project_budget_roleDeletesUpdate an existing project identified by role id. Only the fields you pass are changed. Destructive action; may require approval. API summary: Update a project budget role.
update_an_other_expense_on_a_projectChanges dataUpdate an existing project identified by project id 2. Only the fields you pass are changed. API summary: Update an other expense on a project.
update_checkboxChanges dataUpdate an existing checkbox identified by checkbox field id. Only the fields you pass are changed. API summary: Update a checkbox custom field.
update_checkboxesVisible to othersUpdate an existing checkbox identified by person id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Add a checkbox custom value to a person or placeholder.
update_contact_contractChanges dataUpdate an existing contract identified by contract id. Only the fields you pass are changed. API summary: Update a contract for a person.
update_contact_skillChanges dataUpdate an existing skill identified by skill id. Only the fields you pass are changed. API summary: Update a skill for a person or placeholder.
update_contractChanges dataUpdate an existing contract identified by contract id. Only the fields you pass are changed. API summary: Update a contract.
update_customerChanges dataUpdate an existing customer identified by customer id. Only the fields you pass are changed. API summary: Update a client.
update_dateChanges dataUpdate an existing date identified by date field id. Only the fields you pass are changed. API summary: Update a date custom field.
update_datesVisible to othersUpdate an existing date identified by person id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Add a date custom value to a person or placeholder.
update_people_tagChanges dataUpdate an existing people tag identified by people tag id. Only the fields you pass are changed. API summary: Update a people tag.
update_personChanges dataUpdate a person by `contact_id`: name, email, team, managers, tags or archived. Only the fields you pass change.
update_projectChanges dataUpdate a project by `project_id`: name, client, budget, manager, tags, confirmed or archived. Only the fields you pass change.
update_project_2Changes dataUpdate an existing project identified by project id. Only the fields you pass are changed. API summary: Update a project tag.
update_project_milestoneChanges dataUpdate an existing milestone identified by milestone id. Only the fields you pass are changed. API summary: Update a milestone for a project.
update_project_person_requestChanges dataUpdate an existing person request identified by person request id. Only the fields you pass are changed. API summary: Update the status of a person request on a project.
update_project_timesheet_locksVisible to othersUpdate an existing timesheet lock identified by project id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update a timesheet lock for a project.
update_project_update_project_rateChanges dataUpdate an existing project identified by project id 2. Only the fields you pass are changed. API summary: Update a rate for a role on a project.
update_rate_cardChanges dataUpdate an existing rate card identified by rate card id. Only the fields you pass are changed. API summary: Update a rate card.
update_roleDeletesUpdate an existing role identified by role id. Only the fields you pass are changed. Destructive action; may require approval. API summary: Update a role.
update_selectChanges dataUpdate an existing select identified by select field id. Only the fields you pass are changed. API summary: Update a select custom field.
update_select_optionChanges dataUpdate an existing option identified by select option id. Only the fields you pass are changed. API summary: Update a select custom field option.
update_selectsVisible to othersUpdate an existing select identified by person id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Add custom select options to a person or placeholder.
update_skillChanges dataUpdate an existing skill identified by skill id. Only the fields you pass are changed. API summary: Update a skill.
update_teamChanges dataUpdate an existing team identified by team id. Only the fields you pass are changed. API summary: Update a team.
update_textChanges dataUpdate an existing text identified by text field id. Only the fields you pass are changed. API summary: Update a text custom field.
update_textsVisible to othersUpdate an existing text identified by person id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Add a text custom value to a person or placeholder.
update_userChanges dataUpdate an existing user identified by user id. Only the fields you pass are changed. API summary: Update a user.
update_user_viewChanges dataUpdate an existing view identified by view id. API summary: Allocate a view to a user.
update_workstreamChanges dataUpdate an existing workstream identified by workstream id. Only the fields you pass are changed. API summary: Update a workstream.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Runn from the app list.
2
Paste your key
Enter your Runn API address and an API token. Use https://api.runn.io for EU accounts or https://api.us.runn.io for US accounts. You must be a Runn administrator: open Settings > API, create a token (choose read or write access and an optional expiry) and copy it.
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 Runn?

The AI can read people, clients, projects, project totals, phases, milestones, assignments, actuals, leave, roles, teams and skills. It can create projects, clients, people, assignments, leave, time entries, project notes and milestones, update projects and people, and delete assignments.

Does the AI see my Runn API token?

No. Your Runn API token is encrypted at rest and never shown to the AI. After you save it, it is 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 read-only. Deleting an assignment is permanent and can require your approval before it runs. You can also create the Runn token with read access only. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then 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?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Runn account.

Which Runn API address should I use?

It depends on where your Runn account is hosted. Use https://api.runn.io for EU accounts and https://api.us.runn.io for US accounts. You also need to be a Runn administrator to create the API token.