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.

27 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_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_assignmentChanges dataSchedule a person on a project: `person_id`, `project_id`, `role_id`, `start_date`, `end_date` and `minutes_per_day`.
create_clientChanges dataCreate a client with a `name` and optional website.
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_personChanges dataAdd a person with first and last name, `role_id`, and optionally email, team, start date, cost per hour and employment details.
create_projectChanges dataCreate a project. Pass the project fields in `body`, such as name and client ID.
create_project_milestoneChanges dataAdd a milestone to a project by `project_id` with a `title`, `date` and `icon`.
delete_assignmentDeletesPermanently delete an assignment by `assignment_id`. This cannot be undone.
get_clientGet one client by `customer_id` (the client ID).
get_meGet the Runn account and user the API token belongs to.
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_totalsGet the totals for a project by `project_id`: scheduled and actual hours, revenue and cost.
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_clientsList clients, optionally filtered by `name`.
list_leaveList leave (time off) entries, filtered by `person_id` and a `start_date` to `end_date` range.
list_peopleList people, filtered by `first_name`, `last_name`, `email` or `external_id`.
list_project_milestonesList the milestones of a project by `project_id`.
list_project_phasesList the phases of a project by `project_id`.
list_projectsList projects, optionally filtered by `name` (partial match) or `external_id`. Set `include_archived` to include archived projects.
list_rolesList roles, optionally filtered by `name`. Use this to find a role ID.
list_skillsList the skills defined in Runn.
list_teamsList teams. Use this to find a team ID.
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.

Set up in three steps

1
Pick the app
Create a free PipMCP 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 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?

PipMCP 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.