Hub Planner MCP server
71 operations0 webhooks
Resource scheduling, project planning, timesheet tracking, and team capacity management.
Try Hub Planner with your agent
Connect Hub Planner, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Hub Planner on my account, then run one read-only example and show me the result.
Hub Planner tools and triggers
Tools are what your agent can do in Hub Planner through Corsair's MCP server. Triggers are the Hub Planner events a routine can start from.
Projects
- Add ClientsWrite
Associate client organizations with a project
projects.addClients
- Add ResourcesWrite
Assign resources to a project
projects.addResources
- Add TagsWrite
Add tags to a project
projects.addTags
- CreateWrite
Create a new project
projects.create
- DeleteDestructive
Delete a specific project by ID
projects.delete
- Delete BulkDestructive
Delete multiple projects by their IDs
projects.deleteBulk
- GetRead-only
Get project details by project ID
projects.get
- Get TagsRead-only
List tags associated with a project
projects.getTags
- ListRead-only
List all projects with pagination and sorting
projects.list
- Remove ClientWrite
Dissociate a client organization from projects
projects.removeClient
- Remove ResourceWrite
Remove a resource from multiple projects
projects.removeResource
- Remove TagDestructive
Remove a tag from a project
projects.removeTag
- SearchRead-only
Search projects matching custom criteria
projects.search
- Set Project ManagersDestructive
Replace the project manager list of a project (managers not listed are removed)
projects.setProjectManagers
- UpdateWrite
Bulk update projects with modified attributes
projects.update
Categories
- CreateWrite
Create a new booking category in a group
categories.create
- Create Cost CategoryWrite
Create a new project cost category
categories.createCostCategory
- Delete Cost CategoryDestructive
Delete a project cost category by ID
categories.deleteCostCategory
- GetRead-only
Get booking category details by category ID
categories.get
- Get Cost CategoryRead-only
Get project cost category by ID
categories.getCostCategory
- ListRead-only
List all booking categories
categories.list
- List Cost CategoriesRead-only
List all project cost categories
categories.listCostCategories
- List GroupsRead-only
List booking category groups
categories.listGroups
- SearchRead-only
Search booking categories by name or group
categories.search
- Search Cost CategoriesRead-only
Search project cost categories by name
categories.searchCostCategories
- UpdateWrite
Update an existing booking category
categories.update
- Update Cost CategoryWrite
Update an existing project cost category
categories.updateCostCategory
Resources
- Add TagsWrite
Add tags to a resource
resources.addTags
- CreateWrite
Create a new resource member
resources.create
- DeleteDestructive
Delete a specific resource by ID
resources.delete
- Delete BulkDestructive
Delete multiple resources by their IDs
resources.deleteBulk
- GetRead-only
Get resource details by resource ID
resources.get
- Get TagsRead-only
List tags associated with a resource
resources.getTags
- ListRead-only
List all resources with pagination and sorting
resources.list
- Remove TagDestructive
Remove a tag from a resource
resources.removeTag
- SearchRead-only
Search resources matching custom criteria
resources.search
- UpdateWrite
Bulk update resources with modified attributes
resources.update
Bookings
- CreateWrite
Create a new resource schedule booking
bookings.create
- DeleteDestructive
Delete a specific booking by ID
bookings.delete
- Delete BulkDestructive
Bulk delete bookings by IDs, or every booking of one resource or one project
bookings.deleteBulk
- GetRead-only
Get booking details by booking ID
bookings.get
- ListRead-only
List scheduled bookings with pagination and filters
bookings.list
- PatchWrite
Patch specific properties of a booking or approve/reject booking requests
bookings.patch
- SearchRead-only
Search bookings matching criteria such as date range or project
bookings.search
- UpdateWrite
Update all properties of an existing booking
bookings.update
Custom Fields
- Add ChoicesWrite
Add options to dropdown or selection custom field templates
customFields.addChoices
- CreateWrite
Create a new custom field template for projects or resources
customFields.create
- DeleteDestructive
Delete a custom field template by ID
customFields.delete
- GetRead-only
Get custom field template details by ID
customFields.get
- ListRead-only
List custom field templates for projects or resources
customFields.list
- SearchRead-only
Search custom field templates matching filter parameters
customFields.search
- UpdateDestructive
Replace a custom field template; choices left out of the array are removed from records
customFields.update
Time Entries
- CreateWrite
Log new time entry on a project for a resource
timeEntries.create
- DeleteDestructive
Delete a timesheet entry by ID
timeEntries.delete
- Delete BulkDestructive
Delete multiple timesheet entries by their IDs
timeEntries.deleteBulk
- GetRead-only
Get timesheet entry details by ID
timeEntries.get
- ListRead-only
List recorded timesheet entries with pagination and filters
timeEntries.list
- SearchRead-only
Search time entries matching date ranges and resource/project filters
timeEntries.search
- UpdateWrite
Update an existing timesheet entry
timeEntries.update
Events
- CreateWrite
Create a new company event
events.create
- DeleteDestructive
Delete a company event by ID
events.delete
- GetRead-only
Get company event details by event ID
events.get
- ListRead-only
List company events with pagination and sorting
events.list
- SearchRead-only
Search events by name or event code
events.search
- UpdateWrite
Update an existing company event
events.update
Milestones
- CreateWrite
Create a new project milestone date
milestones.create
- DeleteDestructive
Delete a project milestone by ID
milestones.delete
- GetRead-only
Get milestone details by milestone ID
milestones.get
- ListRead-only
List milestones with pagination and sorting
milestones.list
- SearchRead-only
Search milestones by project or date range
milestones.search
- UpdateWrite
Update an existing project milestone
milestones.update
Connect Hub Planner to Claude, ChatGPT or Cursor
- 1
Connect Hub Planner in Corsair
Add your Hub Planner API key once in Corsair. Corsair stores the credential encrypted and makes the Hub Planner API calls for your agent, so it never goes into a prompt or a config file. Connect Hub Planner
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Hub Planner. On a ChatGPT personal plan, connect Hub Planner here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Hub Planner's read and write operations run right away and its 16 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/hubplanner, add the Hub Planner plugin, and connect with an API key. Then call methods like corsair.hubplanner.api.bookings.create() from your app. Corsair keeps each tenant isolated.
Yes. Hub Planner requires an API key from your Hub Planner account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Hub Planner, GitHub, Notion, Stripe, and the rest. Trigger Hub Planner from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for resource scheduling, project planning, timesheet tracking, and team capacity management. Common builds include sync jobs, admin tooling, and agents that call Hub Planner APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Hub Planner API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/hubplanner in the open repo. When Hub Planner ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Hub Planner data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Hub Planner data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Hub Planner on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 16 destructive Hub Planner operations. You can change a link's mode at hub.corsair.dev/me.