Hub Planner MCP server

Connect Hub Planner to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Hub Planner MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the search time entries tool in Hub Planner
  • Use the search projects tool in Hub Planner
  • Use the manage holiday tool in Hub Planner
  • Use the search bookings tool in Hub Planner
  • Use the manage time entry tool in Hub Planner
  • Use the search resources tool in Hub Planner

Supported Tools

search_time_entries

Search Time Entries

Search and filter timesheet entries using advanced query operators. Filter by resource, project, date ranges, and status. Use page and limit to retrieve additional results; the API returns 20 entries by default. Use operators like **$in**, **$nin**, **$lt**, **$lte**, **$gt**, **$gte** for flexible querying.

search_projects

Search Projects

Search and filter projects using advanced query operators. Supports filtering by name, status, project code, resources, date ranges, and custom fields. Use operators like **$in**, **$nin**, **$like**, **$lt**, **$lte**, **$gte** for flexible querying.

manage_holiday

Manage Holiday

Create, update, or delete a public holiday in Hub Planner. When creating, **name** and **date** are required. Holidays can be set to repeat annually.

search_bookings

Search Bookings

Search and filter bookings using advanced query operators. Filter by resource, project, date ranges, and more. Use page and limit to retrieve additional results; the API returns 20 bookings by default. Use operators like **$in**, **$nin**, **$lt**, **$lte**, **$gte**, **$gt** for flexible querying.

manage_time_entry

Manage Time Entry

Create, update, or delete a timesheet entry in Hub Planner. Time entries track actual time worked by resources against projects. When creating, **resourceId**, **projectId**, **date**, and **minutes** are required. Requires the Timesheets extension.

search_resources

Search Resources

Search and filter resources using advanced query operators. Supports filtering by name, email, status, role, and custom fields. Use operators like **$in**, **$nin**, **$like** for flexible querying.

manage_event

Manage Event

Create, update, or delete an event in Hub Planner. Events are schedulable items similar to projects but for non-project activities. When creating, **name** is required.

manage_milestone

Manage Milestone

Create, update, or delete a project milestone in Hub Planner. When creating, **name**, **date**, and **projectId** are required. Milestones mark key dates within projects.

manage_vacation

Manage Vacation

Create, update, or delete vacation/time-off records for resources in Hub Planner. When creating, **resourceId**, **start**, **end**, and **type** are required.

get_booking

Get Booking

Retrieve a single booking by ID, or list a page of bookings. The API returns 20 by default; continue paging until fewer than the requested limit are returned. Returns booking details including resource, project, dates, state, and duration.

manage_resource

Manage Resource

Create, update, or delete a resource (team member) in Hub Planner. When creating, **firstName** is required. Resources can have statuses like Active, Archived, Non-Bookable, or Parked.

manage_client

Manage Client

Create, update, or delete a client record in Hub Planner. Clients can be associated with projects. When creating, **name** is required.

manage_booking

Manage Booking

Create, update, or delete a resource booking in Hub Planner. Bookings schedule resources onto projects for specific date ranges. When creating, **resourceId**, **projectId**, **start**, and **end** are required. Supports percentage-based and minute-based allocation and booking requests.

manage_project

Manage Project

Create, update, or delete a project in Hub Planner. Use **action** to specify the operation. When creating, only **name** is required. When updating, provide the **projectId** and any fields to change. Projects can have statuses like Active, Archived, Planned, Pending, or Floating.

get_resource

Get Resource

Retrieve a single resource by ID, or list all resources with optional pagination. Returns resource details including name, email, status, role, and custom fields.

list_booking_categories

List Booking Categories

List all booking categories and category groups in Hub Planner. Booking categories are used to classify different types of bookings. Optionally retrieve a specific category by ID.

get_project

Get Project

Retrieve a single project by ID, or list all projects with optional pagination. Returns full project details including name, status, dates, budget, resources, and custom fields.

get_time_entry

Get Time Entry

Retrieve a time entry by ID, or list a page of timesheet entries. Returns resource and project IDs, dates, minutes, status, and locking information. The API defaults to 20 entries per page; continue paging until fewer than the requested limit are returned.

list_clients

List Clients

List client records or retrieve one client by ID. Discover stable client IDs and names before updating or deleting clients.

list_events

List Events

List schedulable events or retrieve one by ID. Discover event IDs for updating events or creating bookings for non-project activities; pass an event ID as the booking projectId.

Connect Hub Planner to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Hub Planner in Metorial. In your Metorial portal, enable the Hub Planner MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Hub Planner tools.

Run Hub Planner through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Hub Planner and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Hub Planner tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Hub Planner

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.

Jira

Create, read, update, and delete issues across projects. Search issues using JQL queries. Manage projects, boards, sprints, and epics for agile workflows. Log work time, add comments and attachments, and transition issues through workflow statuses. Create and manage project versions/releases, issue links, filters, and dashboards. Query users, groups, and permissions.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Technical notes for Hub Planner

Manage resource scheduling, project planning, bookings, and timesheets. Create, retrieve, update, delete, and search projects and resources. Schedule bookings with percentage or minute-based allocation, retrieve booking categories, and track actual time through timesheet entries. Discover clients and schedulable events, and manage events, project milestones, vacations, and public holidays.

Frequently asked questions

Common questions about connecting Hub Planner to AI agents with Metorial.

  1. How many tools does the Hub Planner MCP server have?
    The Hub Planner MCP server exposes 20 tools, including Search Time Entries, Search Projects, Manage Holiday. Each one is governed and traced through Metorial.
  2. Hub Planner exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Hub Planner MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Hub Planner and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Hub Planner MCP server yourself or use the hosted gateway.

Connect Hub Planner to production AI agents

See how Metorial gives your team governed access to Hub Planner, with tracing and security controls built in.