MCP Tools Reference
Tools available through the IC Project MCP server.
The IC Project MCP server exposes 71 tools. They act as the authenticated user in the IC Project instance selected during OAuth.
Your MCP client picks the tools from your request. You do not need to name a tool. For the parameter names, types, and schemas, use the tools/list MCP command in your client.
Tool kinds
Each tool has one of three kinds. The server reports the kind to your client as MCP tool annotations.
| Kind | What the tool does | Annotations |
|---|---|---|
| Read | Reads data and changes nothing. | readOnlyHint: true |
| Create | Adds data and does not change existing data. | readOnlyHint: false, destructiveHint: false |
| Change | Updates, moves, or deletes existing data. | readOnlyHint: false, destructiveHint: true |
Your MCP client can ask you to confirm a tool call before it runs a Create or Change tool.
Delete tools remove data from IC Project.
How the assistant works with the tools
When your client connects, the server sends it instructions for the assistant. They tell the assistant to:
- Search for existing data before it creates or changes data, and ask you for details if it cannot find the data.
- Create, update, or delete at most 10 items at a time, and check the result of each batch before the next one.
The data in IC Project is organized as project, stage, board, board column, and task. Most tools take the ID of an item at one of these levels. The assistant gets the IDs from search, the list tools, and the details tools.
Search
| Tool | Kind | Description |
|---|---|---|
search | Read | Searches projects, stages, boards, tasks, and task checklists by name, description, or task number. You can limit the search to some of these types. |
Projects
| Tool | Kind | Description |
|---|---|---|
project_list | Read | Lists projects. Filters include status, category, tags, contractors, planned end date, favorites, and projects you are a member of. |
project_details | Read | Returns one project with its stages and boards. |
project_category_list | Read | Lists project categories. |
project_tag_list | Read | Lists project tags. |
project_template_list | Read | Lists project templates. |
project_create | Create | Creates a project. It can copy the structure of a project template. |
project_update | Change | Updates the name, description, planned dates, budget, category, tags, or contractors of a project. |
project_set_favorite | Change | Adds a project to your favorites or removes it from them. |
project_delete | Change | Deletes a project. |
Stages
| Tool | Kind | Description |
|---|---|---|
stage_list | Read | Lists the stages of a project. |
stage_details | Read | Returns one stage. |
stage_create | Create | Creates a stage in a project. |
stage_update | Change | Updates the name, description, or dates of a stage. |
stage_delete | Change | Deletes a stage. |
Boards
| Tool | Kind | Description |
|---|---|---|
board_list | Read | Lists the boards of a stage. |
board_details | Read | Returns one board. |
board_create | Create | Creates a board in a stage with three columns: To Do, In Progress, and Done. |
board_update | Change | Updates the name, description, or dates of a board. |
board_move_to_stage | Change | Moves a board and its tasks to another stage of the same project. |
board_delete | Change | Deletes a board. |
Board columns
| Tool | Kind | Description |
|---|---|---|
board_column_list | Read | Lists the columns of a board. |
board_column_create | Create | Creates a column on a board. The column status is todo, in-progress, or done. |
board_column_update | Change | Updates the name or status of a column. |
board_column_delete | Change | Deletes a column. |
Tasks
| Tool | Kind | Description |
|---|---|---|
task_list | Read | Lists tasks. Filters include project, stage, board, column, column status, assignees, your own tasks, priority, task type, deadline, and overdue tasks. |
task_details | Read | Returns one task with its checklists, comments, and dependencies. |
task_type_list | Read | Lists task types. |
task_create | Create | Creates a task in a board column with a name, description, dates, priority, and assignees. |
task_copy | Create | Copies a task into a column on the same board or another board. The copy keeps the task types and planned time, and can include the checklists and comments. The copy has no members. |
task_dependency_create | Create | Links two tasks. With a blocking dependency, one task waits for the other. With an informational dependency, the tasks are only related. |
task_update | Change | Updates the name, description, dates, priority, column, story points, task types, planned time, or read-only setting of a task. |
task_move | Change | Moves a task and its members to a column on another board, with new dates. It can also move the logged time, costs, and finance items. |
task_dependency_delete | Change | Removes a dependency between two tasks. |
task_delete | Change | Deletes a task. |
Task checklists
| Tool | Kind | Description |
|---|---|---|
task_checklist_create | Create | Creates a checklist on a task. |
task_checklist_item_create | Create | Adds an item to a checklist. |
task_checklist_update | Change | Renames a checklist. |
task_checklist_item_update | Change | Renames, checks, or unchecks a checklist item. |
task_checklist_delete | Change | Deletes a checklist. |
task_checklist_item_delete | Change | Deletes a checklist item. |
Task comments
| Tool | Kind | Description |
|---|---|---|
task_comment_create | Create | Adds a comment to a task, or a reply to a comment. |
task_comment_update | Change | Edits a comment. |
task_comment_delete | Change | Deletes a comment. |
Statuses
| Tool | Kind | Description |
|---|---|---|
set_status | Change | Opens, suspends, or archives a project, stage, or board, and opens or archives a task. To suspend a task, suspend its board. When it opens a project, stage, or board, it can also open everything inside it. |
Members
| Tool | Kind | Description |
|---|---|---|
member_list | Read | Lists the members of a project, board, or task. |
member_assign | Create | Adds users to a project, board, or task. Users added to a board or task are also added to its board and project. |
member_remove | Change | Removes a user from a project, board, or task. Users removed from a project are also removed from its boards and tasks. |
project_member_update | Change | Changes the role, hourly rate, or time-reporting permission of a project member. Only external users can lose the permission to report time. |
task_member_update | Change | Changes the role or planned time of a task member. |
Users and contractors
| Tool | Kind | Description |
|---|---|---|
current_user_info | Read | Returns the user you are connected as. |
user_list | Read | Lists users. You can search by first name, last name, or email. |
contractor_list | Read | Lists contractors, the clients that projects are done for. |
Reported time
| Tool | Kind | Description |
|---|---|---|
reported_time_list | Read | Lists time entries. Filters include user, project, task, time type, and date range. |
timesheet | Read | Returns the time logged in one 7-day window, grouped by user or by task. |
reported_time_daily_totals | Read | Returns the total time logged per day for a user, a project, or both. |
reported_time_type_list | Read | Lists time types. |
report_time_on_task | Create | Logs time on a task for a user and a date, with an optional description and time type. |
reported_time_update | Change | Updates the date, duration, description, or time type of a time entry. |
reported_time_delete | Change | Deletes a time entry. |
Finance
| Tool | Kind | Description |
|---|---|---|
project_finance_summary | Read | Returns the estimated and actual costs, the planned and actual income, and the result of a project. It adds one row for each stage, board, or task, down to the level you choose. |
finance_entry_list | Read | Lists costs or incomes, newest first. Filters include project, stage, board, task, date range, and billed or posted status. |
finance_reference_data | Read | Lists tax rates, cost categories, and income categories. |
invoice_list | Read | Lists invoices, newest first, with the amount still unpaid. |
finance_entry_create | Create | Creates a cost or an income, optionally attached to a project, stage, board, or task. The gross price is computed from the net price and the tax rate. |
finance_entry_update | Change | Updates a cost or an income. |
finance_estimate_update | Change | Sets or clears the estimated cost or planned income of a project, stage, or board. |
finance_entry_delete | Change | Deletes a cost or an income. |
Calendar events
| Tool | Kind | Description |
|---|---|---|
calendar_event_list | Read | Lists calendar events. Filters include date range, assigned user, event type, task, and recurring events. |
calendar_event_create | Create | Creates a calendar event with attendees, external guests invited by email, a location, and an optional recurrence rule. |
Activity stream
| Tool | Kind | Description |
|---|---|---|
stream_item_list | Read | Lists the events in the activity stream. Filters include project, stage, board, task, ticket, category, user, and date range. |