add_task_assignees
ChatGPTAssigns one or more resources to a task, in addition to any resources already assigned. Requires a task_id and a list of resource IDs. Call get_resources first to resolve names to IDs, and get_task to see who is already assigned via its assigneeIds field. Assigning a resource that is already assigned to the task has no effect for that resource. Use remove_task_assignees to unassign resources instead. ProjectManager sends each newly assigned resource an email notification by default, unless this specific notification has been turned off.
add_task_tags
ChatGPTAdds one or more tags to an existing task, preserving its other tags. Requires a task ID and tag names. Use get_tags to look up available workspace tags and get_task to see the task's current tags. Names are matched case-insensitively. A name that does not exist creates a workspace tag with an automatically chosen colour and applies it to the task; use an existing name when creation is not intended. Adding a tag already applied to the task has no additional effect. Use remove_task_tags to detach tags.
create_link
ChatGPTCreates a task dependency (link) between two tasks in the same ProjectManager project: a predecessor task (task_id) and a successor task (successor_task_id). This only affects scheduling within the project and does not connect to any external system. Optionally accepts link_type (finishToStart, startToStart, finishToFinish, startToFinish; defaults to finishToStart) and lag (days of lag, or lead if negative; defaults to 0). Both tasks must be in the same project, cannot be the same task, cannot already be linked, and the successor cannot be a summary task or a descendant of a summary predecessor. Rejects dependencies that would create a circular dependency. Use get_tasks/get_task first to obtain valid task IDs.
create_project
ChatGPTCreates a new project in the workspace. Returns the new project ID (project code, e.g. H2) and name. Use get_resources to resolve member IDs before granting access via member_ids. If member_ids is omitted, only the current user will have access. Requires workspace permission to create projects.
create_task
ChatGPTCreates a new task within a specified project. Requires a task name and a project ID. Optionally accepts: assignees - a list of resource IDs to assign to this task, call get_resources first to resolve names to IDs; parent_task_id - the ID of a parent task, if this task should be a sub-task, use this to build task hierarchies at creation time, parent tasks must be created before their children; theme - a colour for the task, do not use values outside the defined enum; planned_start_date, planned_finish_date - date range for the task; priority - fixed enum values; description - free text description of the work. If assignees are supplied, ProjectManager sends each assignee an email notification by default, unless notifications have been turned off. Returns the newly created task ID. When building a full project task breakdown, create all top-level tasks first, then create sub-tasks passing the relevant parent_task_id.
delete_link
ChatGPTRemoves an existing task dependency (link) between a predecessor task (task_id) and its successor (successor_task_id) in the same ProjectManager project. This only affects scheduling within the project and does not connect to any external system. Only the dependency is removed; neither task is deleted. The dependency's link type and lag are not retained, so call get_links first if it may need to be recreated. The dependency must already exist.
get_links
ChatGPTRetrieves the links from a task (as predecessor) to its successor tasks. Returns, per link, the successor task's ID, link type, and lag. Use this before update_link or delete_link to see a task's existing dependencies.
get_me
ChatGPTRetrieves the currently authenticated user's identity and workspace, including their ID, full name, and workspace name. Use this when you need to know who the current user is or which workspace they are in. No parameters are required.
get_my_projects
ChatGPTRetrieves projects where the currently authenticated user is the assigned manager. Internally resolves the current user's identity; no user ID needs to be provided. Use this when the user wants to see the projects they are responsible for managing, rather than all projects they have access to. For all accessible projects, use get_projects.
get_my_tasks
ChatGPTRetrieves a page of tasks assigned to the currently authenticated user, optionally filtered by project ID, start date, and/or end date. Internally resolves the current user's identity; no user ID needs to be provided by the caller. Like get_tasks, it returns totalCount and hasMore alongside the page, ordered by planned finish date - take counts from totalCount and page through with skip while hasMore is true. Use this when the user asks about their own tasks, workload, or what they need to do next. For tasks across all users or assignees, use get_tasks.
get_overdue_tasks
ChatGPTReturns tasks that are overdue (past planned finish date and not 100% complete). Optionally filter by assignee name.
get_planned_progress_per_day
ChatGPTReturns the percentage of project progress that should be complete on each calendar day of a requested month when the project is exactly on schedule (zero ahead and zero behind). The calculation uses the currently saved plan, including task dates, durations, and the project calendar; it does not use historical series data or actual task progress. Use get_projects first to resolve the project ID.
get_project
ChatGPTRetrieves detailed information for a single project by ID, including schedule dates, progress, status, description, a URL to open the project in ProjectManager, and a consolidated list of all project and task file attachments (name, type, date, a full download URL, and task ID when attached to a task). Share file URLs so the user can click them. Do not download or fetch file contents yourself. Share the project URL when the user should open the project in PM. Use get_projects first to resolve a project ID from a name. Project ID is the project code (e.g. H2), not a GUID. File download URLs require the same authenticated session as this MCP connection.
get_project_members
ChatGPTRetrieves the list of members on a project, including their resource ID, name, and permission level. Use get_resources to resolve member names to IDs when creating tasks. Call get_projects first to resolve the project ID (project code, e.g. H2).
get_project_metrics
ChatGPTReturns pre-calculated project metrics for insights: EVM (BAC, PV, EV, AC, CPI, SPI), burndown series, cost variance rows, cost/hours summary, progress s-curve points, and actualCostSeries - cumulative actual resource cost from timesheets by date, for actual cost over time lines. Call this before generating EVM, burndown, cost, or progress insight charts — use these values in tables and charts; do not recalculate. When the current user does not have permission to see costs and budgets, budget, evm, costVariances, actualCostSeries and the cost values in costHoursSummary are omitted; do not estimate or infer them.
get_project_summary
ChatGPTReturns summary information about a project including name, dates, budget, task counts, and schedule health. budget is null when the current user does not have permission to see costs and budgets.
get_project_tasks
ChatGPTReturns non-summary, non-milestone project tasks with planned start and finish dates, percent complete, planned and actual cost (material plus resource cost), planned and actual hours, and assignee names. Use this for per-task cost or hours charts and tables. Use filters to narrow results. plannedCost and actualCost are null when the current user does not have permission to see costs and budgets.
get_projects
ChatGPTRetrieves the list of projects in the workspace that the current user has access to, including their ID, name, and status. Project ID is the project code (e.g. H2). Use this before calling get_project, get_tasks, create_task, or create_project to resolve project IDs. If a user refers to a project by name, call this tool first to look up their project ID. If a name matches more than one project, present the options and ask the user to confirm before proceeding.
get_resource_workload
ChatGPTReturns workload summary showing how many open tasks each assignee has on a project.
get_resources
ChatGPTRetrieves the list of available resources (team members) in the workspace, including their ID, name, and email address. Use this before calling create_project to resolve member IDs, or before calling create_task to resolve assignee IDs. If a user refers to a team member by name, call this tool first to look up their resource ID. If a name matches more than one resource, present the options and ask the user to confirm before proceeding.
get_tags
ChatGPTRetrieves a page of available tags in the current workspace, including each tag's ID, name and colour. Includes tags that are not currently applied to any task. Optionally filter by a partial tag name. Results are ordered by name and include totalCount, skip and hasMore; while hasMore is true, increase skip by the number of tags retrieved to get the next page. Use this to resolve existing tag names before add_task_tags, remove_task_tags or filtering get_tasks by tags. Pass tag names, rather than IDs, to those tools. To see a particular task's applied tags, use get_task. This tool only looks up tags; it does not create, rename, recolour or delete them.
get_task
ChatGPTRetrieves full details for a single task by its ID, including name, description, status, assignee, due date, priority, theme, parent project ID, planned and actual dates, costs, effort, WBS, a URL to open the task in ProjectManager, and any file attachments. File attachments are returned as an array containing the name, type, creation date, and a full download URL for each file. Share those file URLs so the user can click them. Do not download or fetch file contents yourself. Share the task URL when the user should open the task in PM. Use this when you already know the task ID. To search for tasks across a project or date range, use get_tasks instead. The project_id returned by this tool can be passed to get_task_statuses when updating a task's status. Planned and actual effort values are returned in minutes but should be displayed in hours and minutes (eg 1hr 30mins not 90mins). plannedCost and actualCost represent material costs only, the total cost of a task is material cost plus resource cost. Create and modify dates are UTC timestamps. Agile users rarely populate the cost and effort fields.
get_task_statuses
ChatGPTRetrieves the list of available task statuses for a given project. Accepts a project ID. Returns each status's ID and name. Use this before calling update_task_status to obtain a valid task_status_id. Statuses are user-defined per project and cannot be assumed. If you only have a task ID, call get_task first to retrieve its project_id, then pass that here.
get_tasks
ChatGPTRetrieves a page of tasks, optionally filtered by project ID, task name, planned start date, due date, create date, assignees, creator, priority, percent complete, and/or tags. Returns task name, status, assignees, dates, creator, priority, percent complete, tags, and parent project for each result, plus totalCount - the number of tasks matching the filters, which is usually larger than the number returned - and hasMore. Tasks come back ordered by planned finish date, so a single page is only the earliest slice of the project, not the whole thing. Always take counts from totalCount rather than counting the returned tasks, and while hasMore is true keep calling with skip increased by the number of tasks already retrieved before answering anything about totals, date ranges, status breakdowns, or who is assigned to what. To retrieve a specific task by ID, including its file attachments, use get_task. To retrieve only tasks assigned to the current user, use get_my_tasks.
remove_task_assignees
ChatGPTRemoves one or more resources from a task's assignees. Requires a task_id and a list of resource IDs. Call get_task first to see who is currently assigned via its assigneeIds field. Removing an assignee also discards any effort allocated to them on this task, and that effort is not restored if they are re-added. Confirm with the user before removing an assignee who has effort allocated. Removing a resource that is not currently assigned has no effect for that resource. Use add_task_assignees to assign resources instead.
remove_task_tags
ChatGPTRemoves one or more tags from an existing task, preserving its other tags. Requires a task ID and tag names. Call get_task first to see the task's current tags, or get_tags to look up workspace tag names. Names are matched case-insensitively. Removing a tag that is not applied has no effect. This only detaches tags from this task; it does not delete or rename workspace tags or affect other tasks. Use add_task_tags to apply tags.
set_task_parent
ChatGPTSets or changes the parent of an existing task, making it a sub-task of the specified parent. Requires a task_id and a parent_task_id. Use this to reorganise task hierarchy after tasks have already been created. To set a parent at creation time, use the parent_task_id parameter on create_task instead; that is more efficient when building a task list from scratch. Both the task and the parent task must belong to the same project.
update_link
ChatGPTUpdates the link type and lag of an existing task dependency (link) between a predecessor task (task_id) and its successor (successor_task_id) in the same ProjectManager project. This only affects scheduling within the project and does not connect to any external system. Both link_type and lag are required and fully replace the existing values. The previous values are not retained, so call get_links first if they may need to be restored. The dependency must already exist; use create_link to create one.
update_project
ChatGPTUpdates one or more fields on an existing project. Accepts the project name, description, target completion date, manager, budget, and free-text status update. Use get_projects first to resolve the project ID. Use get_resources to resolve the manager ID. targetDate is the project's target planned completion date, budget is the proposed project budget, and statusUpdate is free-text progress information (it does not change the project's workflow status). Only supplied fields are updated; omitted fields remain unchanged.
update_task
ChatGPTUpdates one or more fields on an existing task by its ID. Accepts the task name, description, percent complete, planned dates, duration, effort, material cost, colour theme, and milestone toggle. percentComplete must be between 0 and 100; plannedDuration and plannedEffort are measured in minutes; and plannedCost represents material cost only, not total cost. Use only a defined theme enum value. Only supplied fields are updated; omitted fields remain unchanged.
update_task_priority
ChatGPTUpdates the priority of a task by its ID. Accepts a task_id and a priority value. Use this when the user wants to raise or lower the urgency of a task. Priority values are fixed and do not vary per project; no lookup step is required.
update_task_status
ChatGPTUpdates the status of a task by its ID. Requires a task_id and a task_status_id. Valid status IDs for a project can be retrieved using get_task_statuses. Always call that tool first to obtain the correct ID, as statuses are user-defined and vary per project. Do not guess or invent status IDs. If the user's intent maps to more than one plausible status, present the options and ask the user to confirm before proceeding.
add_task_assignees
Claudecreate_link
Claudecreate_project
Claudecreate_task
Claudedelete_link
Claudeget_links
Claudeget_me
Claudeget_my_projects
Claudeget_my_tasks
Claudeget_overdue_tasks
Claudeget_project
Claudeget_project_members
Claudeget_project_metrics
Claudeget_project_summary
Claudeget_project_tasks
Claudeget_projects
Claudeget_resource_workload
Claudeget_resources
Claudeget_task
Claudeget_task_statuses
Claudeget_tasks
Clauderemove_task_assignees
Claudeset_task_parent
Claudeupdate_link
Claudeupdate_project
Claudeupdate_task
Claudeupdate_task_priority
Claudeupdate_task_status
Claude