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 lets AI assistants and other compatible applications work with data in your IC Project instance.
With the MCP server, you can:
- Find projects, stages, boards, tasks, and checklists.
- Review project structures and detailed task information.
- Create, update, move, and delete tasks.
- Manage task checklists and comments.
- Report time against tasks.
Example requests include:
- “Show me my tasks that are currently in progress.”
- “Summarize the Website Redesign project structure.”
- “Create a high-priority task on the Product Launch board.”
- “Add a checklist to this task and mark the first item as complete.”
- “Report two hours of work on this task for today.”
Requirements
To connect, you need:
- An IC Project account with access to an instance.
- 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/mcpTo connect:
- Add the server URL to your MCP client as a remote Streamable HTTP server.
- Start the connection from your client.
- Complete the OAuth flow in the browser window that opens.
- Sign in to IC Project if prompted.
- Select the IC Project instance you want to use and authorize access.
- Return to your MCP client and begin using the available tools.
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 server currently provides tools for search, projects, boards, tasks, checklists, comments, users, and reported time.
Use the tools/list MCP command in your client to retrieve the current tool names and schemas. See the MCP tools reference for a readable overview with example prompts.
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.
