Intervals MCP Server

Connect Claude Desktop to your Intervals account. Ask Claude to track time, manage tasks, look up projects, pull reports, and more — all without leaving your conversation.

Prerequisites

• Claude Desktop installed
• Node.js 18 or later
• An active Intervals account

Check Node.js

Open Terminal and run:

node --version

If you see a version number (e.g. v20.11.0), you're good. If you get "command not found", download and install the LTS version from nodejs.org.

Installation (Mac)

Step 1: Get your Intervals API token

1. Log into myintervals.com
2. Hover over your profile picture
3. Click My Account
4. Click API Access
5. Generate a token if you don't have one, then copy it

Note: Use your own token — do not share it. All activity is attributed to the token owner.

Step 2: Edit the Claude Desktop config

Open the config file directly from Claude:

1. Click your name in the lower-left corner of Claude Desktop
2. Click Settings
3. Click Developer in the left column
4. Click the Edit Config button

Add the intervals block inside mcpServers:

{
  "mcpServers": {
    "intervals": {
      "command": "npx",
      "args": ["-y", "intervals-mcp"],
      "env": {
        "INTERVALS_API_TOKEN": "your_token_here"
      }
    }
  }
}

Replace your_token_here with the token you copied in Step 1.

If you already have other MCP servers configured, add the intervals block alongside the existing entries — don't replace the whole file.

Step 3: Restart Claude Desktop

Quit Claude completely with Cmd+Q, then reopen it.

To verify the setup worked, open a new chat and ask:

"What Intervals tools do you have available?"

Claude should list the available tools (timers, tasks, projects, time entries, etc.).

Example prompts

Once connected, try asking Claude:

• "Show me all open tasks assigned to me"
• "How many hours did I log last week, broken down by project?"
• "Create a task called 'Update onboarding docs' in the Acme project"
• "Start a timer on task 1234"
• "What projects does the Acme client have?"
• "Log 2 hours to the Website Redesign project for today, billable"
• "Show me all unpaid invoices"
• "What work types are available?"

Available tools

| Category | Tools | |---|---| | Timers | Get active timers, start timer, stop timer | | Time entries | List, create, update, delete | | Tasks | List, get, create, update, delete | | Projects | List, get, create, update | | Milestones | List, create, update | | Clients | List, get, create, update | | People | List, get, get current user | | Invoices | List, get, create | | Expenses | List, create | | Reporting | Time summary by project, person, or work type | | Lookups | Work types, task statuses, task priorities |

Troubleshooting

Claude doesn't show Intervals tools

• Make sure you restarted Claude Desktop completely (Cmd+Q, not just closing the window)
• Check that your JSON config is valid — paste it into jsonlint.com to verify
• Confirm Node.js is installed: node --version

"Unauthorized" errors

• Double-check your API token is correct and hasn't been regenerated
• Make sure there are no extra spaces around the token in the config file

npx is slow on first run

• The first time you run npx it downloads the package — this is normal. Subsequent runs use the cache and are much faster.

Security

Your API token is stored only in your local Claude Desktop config file and is never sent anywhere except directly to the Intervals API over HTTPS. The MCP server runs locally on your machine.

License

MIT