Developers

Using the IC Project MCP Server

Connect an AI assistant to IC Project through the Model Context Protocol.

Overview

The IC Project Model Context Protocol (MCP) server connects AI assistants and other MCP clients to your IC Project instance.

With the MCP server, an assistant can:

  • Find projects, stages, boards, tasks, and checklists.
  • Create and change projects, stages, boards, board columns, and tasks.
  • Manage task checklists, comments, dependencies, and members.
  • Log time on tasks and read timesheets.
  • Read project finances, and manage costs, incomes, and estimates.
  • Read and create calendar events, and read the activity stream.

Example requests include:

  • "Show me my overdue tasks."
  • "Summarize the structure of the Website Redesign project."
  • "Create a high-priority task on the Product Launch board and assign it to Anna."
  • "Add a checklist to this task and mark the first item as complete."
  • "Log two hours on this task for today."
  • "How much time did the team log on the Website Redesign project last week?"
  • "Compare the estimated and actual costs of each stage in the Product Launch project."

Requirements

To connect, you need:

  1. An IC Project account with access to an instance.
  2. A compatible MCP client that supports Streamable HTTP transport and OAuth authentication.

Connect to the server

The IC Project MCP server is available at:

https://mcp.icproject.com/mcp

To connect:

  1. Add the server URL to your MCP client as a remote Streamable HTTP server.
  2. Start the connection from your client.
  3. Complete the OAuth flow in the browser window that opens.
  4. Sign in to IC Project if prompted.
  5. Select the IC Project instance you want to use and authorize access.
  6. Return to your MCP client.

Each authorization is connected to the IC Project instance selected during OAuth. The MCP server performs actions as the authenticated user in that instance.

Available tools

The MCP tools reference lists every tool by area. To get the current tool names and schemas, use the tools/list MCP command in your client.

Troubleshooting

If the client cannot connect:

  • Confirm that the server URL is exactly https://mcp.icproject.com/mcp.
  • Confirm that the client supports Streamable HTTP and OAuth.
  • Remove the server from the client and add it again to restart authorization.

If authorization does not complete:

  • Make sure you are signed in to the correct IC Project account.
  • Complete both instance selection and the authorization prompt.
  • Restart the connection from your MCP client if the browser flow was interrupted.

For additional help, contact developer support.

On this page