hub-planner

name

hub-planner

description

Hub Planner is a resource management and scheduling platform that provides team planning, timesheets, leave tracking, and project forecasting, allowing agencies and professional services teams to allocate people effectively, monitor capacity, and coordinate project delivery through integrations and shared workflows. Read and write Hub Planner data through One: projects, bookings, projectcustomfieldtemplates, costcategories, unassignedwork, vacation and more, 134 actions with real parameter documentation. Use whenever the user asks to look something up in Hub Planner, create or update a record there, or build code against the Hub Planner API.

Hub Planner through One

Hub Planner is a resource management and scheduling platform that provides team planning, timesheets, leave tracking, and project forecasting, allowing agencies and professional services teams to allocate people effectively, monitor capacity, and coordinate project delivery through integrations and shared workflows.

One exposes Hub Planner through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform hub-planner if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Hub Planner is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Hub Planner account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Projects

Action	Method	Path	Action id
List Projects	GET	/v1/project	conn_mod_def::GMZ5IhRb0dU::AqGEQXTUQpi7Ai8TO3Cicw
Delete a Project	DELETE	/v1/project/{{id}}	conn_mod_def::GMZ5Ig_jgj4::yxGs-bx_RFase6iogQ5wgg
Delete Multiple Projects	DELETE	/v1/project	conn_mod_def::GMZ5IgqmhMo::We3iAOd8Ru-nMaI7L0ti4Q
Remove a Client from Projects	POST	/v1/project/client/{{id}}	conn_mod_def::GMZ5Iwf16tE::Xp9p7yMzT9KTqPpY1w8QMA
Remove a Resource from Projects	POST	/v1/project/removeResourceFromProjects/{{id}}	conn_mod_def::GMZ5IxXRxe0::p_rhzWvxSsa1rtm8OYQUIA
Search Projects	POST	/v1/project/search	conn_mod_def::GMZ5IwqRilA::U1f9HDLHSGikq7ZZnnwl0A

Bookings

Action	Method	Path	Action id
List Bookings	GET	/v1/booking	conn_mod_def::GMZ5DOUG9Sg::Wt5e-jSoTdOWMFJMQQ8Dqw
Delete Multiple Bookings or Booking Requests (Bulk)	DELETE	/v1/booking	conn_mod_def::GMZ5DO2uHF8::F4KN889PS8eMWGqV7gvGZg
Patch a Booking by ID	PATCH	/v1/booking/{{id}}	conn_mod_def::GMZ5ETtwWWU::M8iuuBtVR_2Byo4w0vG2cg
Search Bookings	POST	/v1/booking/search	conn_mod_def::GMZ5EOmu30I::lL5eiaDVQrCVT3bkIBaIlw
Update a Booking	PUT	/v1/booking/{{id}}	conn_mod_def::GMZ5EPC_pH0::3hMtgojNQ9qrl6vXuPMhpQ

ProjectCustomFieldTemplates

Action	Method	Path	Action id
Get Project Custom Field Templates	GET	/v1/project/customField/template	conn_mod_def::GMZ5FacV1V8::IpSCQmNOSUy8wDLj-lpowA
Get Project Custom Field Templates	GET	/v1/project/customField/template	conn_mod_def::GMZ5IofWl1I::wutdiXmNRiuaVmwDGTmAwA
Search Project Custom Field Templates	POST	/v1/project/customField/template/search	conn_mod_def::GMZ5FktEfUo::9XhbhsciQh60uQrc-mj_kA
Search Project Custom Field Templates	POST	/v1/project/customField/template/search	conn_mod_def::GMZ5Ix5xw9s::bMO3vL3rSy-QWf9DNuGFQw
Search Project Custom Field Templates	POST	/v1/project/customField/template/search	conn_mod_def::GMZ5KlL7TwU::5uWttk_TQ_agG-QU1ZkPtQ

CostCategories

Action	Method	Path	Action id
Get a Project Cost Category by ID	GET	/v1/costCategories/{{id}}	conn_mod_def::GMZ5IF7vbaQ::cFyK19GrReikSIisedKceg
Create a Project Cost Category	POST	/v1/costCategories	conn_mod_def::GMZ5IJzPmJQ::2_NXWNWFSjmBc-kAXgDVJw
Delete a Project Cost Category	DELETE	/v1/costCategories/{{id}}	conn_mod_def::GMZ5HsI-apo::BGxrxGboS2uTtCTqxrT5fg
Search Project Cost Categories	POST	/v1/costCategories/search	conn_mod_def::GMZ5IB1_RCQ::LlwGGY3pRKiaJhHwv3CqLA
Update an Existing Project Cost Category	PUT	/v1/costCategories/{{id}}	conn_mod_def::GMZ5IC5mxrE::sXz0THWqSDiDYrlV35-71g

UnassignedWork

Action	Method	Path	Action id
Get All Unassigned Work	GET	/v1/unassigned-work	conn_mod_def::GMZ5Lhh5P4k::UqXpDOmzT_yLdPDe8P48eQ
Get Specific Unassigned Work	GET	/v1/unassigned-work/{{id}}	conn_mod_def::GMZ5LjdNTyI::VSxc6zZiR_S2b74Pia89tw
Create Unassigned Work	POST	/v1/unassigned-work	conn_mod_def::GMZ5LivgDP8::mv5kXMZDTp2o-aWTn9u_uQ
Delete Unassigned Work	DELETE	/v1/unassigned-work/{{id}}	conn_mod_def::GMZ5LK4grEs::AXljgMT-RGeTeKdHfo1ceg
Update an Unassigned Work	PUT	/v1/unassigned-work/{{id}}	conn_mod_def::GMZ5LitXGJY::t0LezAOQRhSioqxGPywpkg

Vacation

Action	Method	Path	Action id
Get a Specific Vacation	GET	/v1/vacation/{{id}}	conn_mod_def::GMZ5LsgMR04::0YLXr34NRAe4mz6wPNGwwg
Create a Vacation	POST	/v1/vacation	conn_mod_def::GMZ5Lq6DHBE::IaCFypE3ScKa2j7-DMKLbQ
Delete a Vacation	DELETE	/v1/vacation/{{id}}	conn_mod_def::GMZ5Li6qEac::EJ6dxjJwQr6jai8iSyPQMg
Patch a Vacation	PATCH	/v1/vacation/{{id}}	conn_mod_def::GMZ5LqVuqvk::p23NBh_uTHiIBNt7SEUD0g
Update Vacation	PUT	/v1/vacation/{{id}}	conn_mod_def::GMZ5LzAaGF4::s-StxO0WR_6RqqJd4r54sA

BillingRate

Action	Method	Path	Action id
Get a Specific Billing Rate by ID	GET	/v1/billingRate/{{id}}	conn_mod_def::GMZ5BkHmkac::ql7wYmovRKGvQwHdPEQdWw
Create a Billing Rate	POST	/v1/billingRate	conn_mod_def::GMZ5Bj14fmY::wqUestC0Tay7ylHoLFDpIA
Delete a Billing Rate	DELETE	/v1/billingRate/{{id}}	conn_mod_def::GMZ5BpPYKQo::SDQm60wvRNaWNKYeoImrSw
Update a Billing Rate	PUT	/v1/billingRate/{{id}}	conn_mod_def::GMZ5DCn6dDE::TG7KGHB_Q_OMzTRv7M9jfw

Client

Action	Method	Path	Action id
Get a Client by ID	GET	/v1/client/{{id}}	conn_mod_def::GMZ5EdXOGMM::UoxnCoanTxeKeFKe_Pp_kQ
Create a Client	POST	/v1/client	conn_mod_def::GMZ5Eb0YofQ::lRdAzaolQ-GLwpd6uW2XJg
Delete a Client	DELETE	/v1/client/{{id}}	conn_mod_def::GMZ5FR2elxE::2Y9jiy8_SxaE_U5VG599Vw
Update a Client by ID	PUT	/v1/client/{{id}}	conn_mod_def::GMZ5FZxlers::hbjZrHCjQJK51K-c5Wyhpg

ResourceCustomFieldTemplates

Action	Method	Path	Action id
Get Resource Custom Field Templates	GET	/v1/resource/customField/template	conn_mod_def::GMZ5FklDpbs::pgvQ39vgSWmGmEKNKWLY4w
Get Resource Custom Field Templates	GET	/v1/resource/customField/template	conn_mod_def::GMZ5KfRdXOk::Nk43lFBKRAiY50khpRK7yQ
Add Choices to a Resource Custom Field Template	POST	/v1/resource/customField/template/{{id}}/addChoices	conn_mod_def::GMZ5FseK2Bc::VCqhNfC9SH-Pi8HR_CzuvA
Delete a Resource Custom Field Template by ID	DELETE	/v1/resource/customField/template/{{id}}	conn_mod_def::GMZ5FaoKG3k::a1EeNUrrRmOJ9H2ptRh7cA

ProjectCustomFieldTemplate

Action	Method	Path	Action id
Get a Project Custom Field Template by ID	GET	/v1/project/customField/template/{{id}}	conn_mod_def::GMZ5FbNdjdY::4QgPynU_QmC5fba6ThOq6A
Create a Project Custom Field Template	POST	/v1/project/customField/template	conn_mod_def::GMZ5FkhkS5g::tNTXws4eT5OnkdHJk9wNZw
Delete a Project Custom Field Template	DELETE	/v1/project/customField/template/{{id}}	conn_mod_def::GMZ5FcXcqP4::s9pHn2VsRGKi69JXDPxoLw
Update a Project Custom Field Template	PUT	/v1/project/customField/template/{{id}}	conn_mod_def::GMZ5GkRiwaA::t4nGqGj7QKC2iWnj5tWM5Q

Events

Action	Method	Path	Action id
List Events	GET	/v1/event	conn_mod_def::GMZ5GyZ3-ss::OUVBuFewSSaaYMo550uZnw
Delete an Event	DELETE	/v1/event/{{id}}	conn_mod_def::GMZ5GwvePrc::U1pBh8xTR9CqJgTj9OGMEw
Search Events	POST	/v1/event/search	conn_mod_def::GMZ5GvnyG6E::Iuh7RVLlQcCdh-DZP-pvtQ
Update an Event by ID	PUT	/v1/event/{{id}}	conn_mod_def::GMZ5G6lj45E::vLIhX-HUQtSrxTeuCNXC9A

ProjectGroup

Action	Method	Path	Action id
Get a Specific Project Group	GET	/v1/projectgroup/{{id}}	conn_mod_def::GMZ5G7UuFlQ::L8d3d0W-TZSbgvw8TANMZA
Create a Project Group	POST	/v1/projectgroup	conn_mod_def::GMZ5HGuz3-8::4-_k1GgFSGqIKD5XCwYD9w
Delete a Project Group	DELETE	/v1/projectgroup/{{id}}	conn_mod_def::GMZ5G6HF5Bg::9NKNMAUJQY2gW50UvnqAyw
Update a Project Group	PUT	/v1/projectgroup/{{id}}	conn_mod_def::GMZ5HbnFRR8::lb17kyXiRCyAeZpYrq6FuQ

Milestone

Action	Method	Path	Action id
Get a Specific Milestone	GET	/v1/milestone/{{id}}	conn_mod_def::GMZ5HxIYoyQ::6QkgrLKARjuagCWgNgX0yg
Create a Milestone	POST	/v1/milestone	conn_mod_def::GMZ5HtD258I::evEsHLVZSAOcjhMMpSYY1A
Delete a Milestone	DELETE	/v1/milestone/{{id}}	conn_mod_def::GMZ5HZLl7TE::mY30RbM_QuGKXbZ9avaRmQ
Update a Milestone by ID	PUT	/v1/milestone/{{id}}	conn_mod_def::GMZ5HsADt4g::2DlhddMSQoWKvu46bsHmvQ

ProjectTags

Action	Method	Path	Action id
Get a Project's Tags	GET	/v1/project/{{id}}/tag	conn_mod_def::GMZ5InoaMHY::GfRsnodiSb2_OyDBOnY47g
List Project Tags	GET	/v1/project-tag	conn_mod_def::GMZ5IRDBQEo::rhPdzg7JSt-DwfpuQ3aLzg
Remove a Project Tag from a Project	DELETE	/v1/project/{{projectId}}/tag/{{tagId}}	conn_mod_def::GMZ5Ihhuy2g::P1Re6gk6QkaupbuLwxB9qw
Update a Project Tag	PUT	/v1/project-tag/{{id}}	conn_mod_def::GMZ5IZ6NfqM::-AVvtekBQlWNv9of9pycmw

Project

Action	Method	Path	Action id
Get a Specific Project	GET	/v1/project/{{id}}	conn_mod_def::GMZ5IhYx6os::hBssFf2USGuR_-KzPk00Zg
Add a Project Tag	PATCH	/v1/project/{{id}}/tag	conn_mod_def::GMZ5IoUxwzk::D4RgFsKnRMSbizALnuB9IA
Add Resources to a Project	POST	/v1/project/addResourcesToProject/{{id}}	conn_mod_def::GMZ5Iv57vug::UEeFH3E4Q3KDCBBB7fofhQ
Create a Project	POST	/v1/project	conn_mod_def::GMZ5IoAeMbc::puBqSULISoq4FgPiCTUGzw

Holiday

Action	Method	Path	Action id
Get a Specific Holiday	GET	/v1/holiday/{{id}}	conn_mod_def::GMZ5I5mnPjU::_XESslBDTiKnuZswygCEzA
Create a Holiday	POST	/v1/holiday	conn_mod_def::GMZ5I6VbPxQ::_6c7gZ8DQT2idjmSzzSPPQ
Delete a Holiday	DELETE	/v1/holiday/{{id}}	conn_mod_def::GMZ5I9y4Kok::PNkHwFs-Rpavi9xB6sOsuA
Update a Holiday	PUT	/v1/holiday/{{id}}	conn_mod_def::GMZ5JFGmNyQ::bcK5NbU5RDycZd2R2mSlhg

ResourceTags

Action	Method	Path	Action id
Get a Resource's Tags	GET	/v1/resource/{{id}}/tag	conn_mod_def::GMZ5KhcyNvY::tEhZCqMoRXeUgPB8y8zlHw
List Resource Tags	GET	/v1/resource-tag	conn_mod_def::GMZ5KIVQN50::vsrieocGTN-Bc3P3q4w7Mg
Create a Resource Tag	POST	/v1/resource-tag	conn_mod_def::GMZ5JFGA9b8::Wr1HzWUfR4O25-XY9RRf8A
Remove a Tag from a Resource	DELETE	/v1/resource/{{resourceId}}/tag/{{tagId}}	conn_mod_def::GMZ5KQNfP64::oO-jGzLLSBKCLgVeGridpA

Resource

Action	Method	Path	Action id
Get a Specific Resource	GET	/v1/resource/{{id}}	conn_mod_def::GMZ5KffTl84::kX38XOjPSgCdJVtlOGBblQ
Add a New Resource Tag	PATCH	/v1/resource/{{id}}/tag	conn_mod_def::GMZ5K5KJNpc::1uTJsXuFR7CvOJEupX8f3Q
Create a Resource	POST	/v1/resource	conn_mod_def::GMZ5LDaz05Q::R8ca0VlVTTGo9uRu0OOmAg
Delete a Resource	DELETE	/v1/resource/{{id}}	conn_mod_def::GMZ5KR6rHrc::cCcIcwnoRReJH8N3Z-dnIQ

TimeEntry

Action	Method	Path	Action id
Get a Specific TimeEntry	GET	/v1/timeentry/{{id}}	conn_mod_def::GMZ5LaSTL7M::3DuH8PpoQkKas5IjIiz5Qw
Create a TimeEntry	POST	/v1/timeentry	conn_mod_def::GMZ5LKxQOm0::91lDwcFdTR-Nch1gs3v9EQ
Delete a TimeEntry	DELETE	/v1/timeentry/{{id}}	conn_mod_def::GMZ5K_-_tUI::IlXO__SuQEKV9I2hMgBRtg
Update a TimeEntry	PUT	/v1/timeentry/{{id}}	conn_mod_def::GMZ5LKex07Y::quFnkp18TSyNAkG4yF7mpw

Categories

Action	Method	Path	Action id
Create a Booking Category	POST	/v1/categories	conn_mod_def::GMZ5DAHl570::ZytL9fL0T2CrrH_98VtoUA
Search Booking Categories	POST	/v1/categories/search	conn_mod_def::GMZ5DOfmAmk::8PXBmtT9Saqk3xJhz-NOPw
Update an Existing Booking Category	PUT	/v1/categories/{{id}}	conn_mod_def::GMZ5EEnf1W8::r1yuDix5TDW6NiVeToGMKw

Booking

Action	Method	Path	Action id
Get a Specific Booking	GET	/v1/booking/{{id}}	conn_mod_def::GMZ5ENFjWOk::IxDQB_eaTmyMsnp1vlLYqA
Create a Booking	POST	/v1/booking	conn_mod_def::GMZ5EOOEUUI::xm8TJMxGSsOT0QV-Ph0dvQ
Delete a Booking	DELETE	/v1/booking/{{id}}	conn_mod_def::GMZ5DOiF7ME::VWq2lo0-RbKPUB8681VUig

ResourceCustomFieldTemplate

Action	Method	Path	Action id
Get a Resource Custom Field Template by ID	GET	/v1/resource/customField/template/{{id}}	conn_mod_def::GMZ5Fjwwf0A::DVDunkiHSFu88T4qGCfjVA

2 more ResourceCustomFieldTemplate actions are available through search.

This lists 90 of 134 actions. For anything not here, call search_one_platform_actions with platform hub-planner. The full catalog is at https://www.withone.ai/knowledge/hub-planner.

When a call fails

The error comes from Hub Planner, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/hub-planner

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.