mcp-intervals

[](https://www.npmjs.com/package/mcp-intervals) [](LICENSE)

MCP server for Intervals task management. Lets Claude read and update tasks, add notes, and browse projects and milestones directly from your Intervals account.

Run the interactive installer:

npx mcp-intervals init

This will:

1. Detect your shell (zsh, bash, or PowerShell)
2. Store your API token securely in your shell profile (not in config files)
3. Detect installed MCP clients (Claude Code, Claude Desktop, Cursor, Windsurf)
4. Configure the selected clients

The installer stores your API token as an environment variable in your shell profile (~/.zshrc, ~/.bashrc, or PowerShell profile), keeping it out of project files that might be committed to git. MCP config files only contain the command reference, not the token.

1. Log in to your Intervals account
2. Go to Options (bottom-left) > My Account > API Access
3. Copy your API token

Add the following line to your shell profile:

macOS/Linux (zsh) - Add to ~/.zshrc:

export INTERVALS_API_TOKEN="YOUR_TOKEN"

macOS/Linux (bash) - Add to ~/.bashrc or ~/.bash_profile:

export INTERVALS_API_TOKEN="YOUR_TOKEN"

Windows (PowerShell) - Add to your PowerShell profile:

$env:INTERVALS_API_TOKEN = "YOUR_TOKEN"

Then reload your shell or restart your terminal.

Add this to your MCP config file (token is read from environment):

Claude Code:

claude mcp add intervals --scope user -- npx -y mcp-intervals

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "inte