Add the Jicoo MCP Server to Claude Code

Learn how to add the Jicoo MCP server to Claude Code and use Jicoo features from your terminal.

Prerequisites

MCP endpoint: https://mcp.jicoo.com/

Transport: Streamable HTTP

Authentication: OAuth 2.1 + Dynamic Client Registration (DCR)

Use the root URL shown above. Appending /mcp can cause the resource URL used for authorization to differ from the one used for token refresh, resulting in refresh failures.

Setup Steps

Run the following command in your terminal.

Start Claude Code, run /mcp, and select jicoo to authenticate. On the Jicoo authorization screen in your browser, select the team you want to use and approve access.

Check the Configuration

The get output shows the endpoint URL and configuration scope. If you see Needs authentication before signing in, authenticate through /mcp.

Specify a Scope

--scope local: Available only to you in the current project. This is the default.

--scope user: Available to you across all projects.

--scope project: Shared as part of the project configuration.

For a user-wide configuration:

Migrate an Existing Configuration

If you registered https://mcp.jicoo.com/mcp, remove that configuration, add the root URL, and authenticate again.

Run claude mcp get jicoo to check the existing configuration scope.

Exit any running Claude Code sessions, then remove and re-add the server in the same scope.

Start Claude Code and authenticate through /mcp → jicoo.

The following example uses the local scope. If your configuration uses user or project, replace --scope local in both commands with that scope.

Verify the Connection and Token Refresh

After authentication, call both getBookings and getEventTypes with page=1 and perPage=3, and confirm that each returns data.

To also verify automatic token refresh, repeat both tool calls in the same conversation at least 70 minutes after authentication. Access tokens expire after one hour. Do not manually reauthenticate or use "Clear authentication" during this check; confirm that both tools continue to return data after refresh.

Back to the Jicoo MCP Server Setup Guide

Add the Jicoo MCP Server to Claude Code

Prerequisites#

Setup Steps#

Check the Configuration#

Specify a Scope#