How do I use intervals-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@intervals-mcp start a timer for Acme website redesign" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

de en es ja ko ru zh

intervals-mcp

by sixfeetup

Overview Schema Related Servers Score Discussions

TypeScript

Local

intervals-mcp

A standalone MCP server, CLI, and Claude Code plugin for local-first Intervals time tracking. Starting a timer or logging a time entry hits a local SQLite database first; entries sync to Intervals in the background or on demand. Reports and queries are always local-only and never call the Intervals API.

Install (Claude Code plugin)

/plugin marketplace add sixfeetup/intervals-mcp
/plugin install intervals@intervals-mcp

There is no build step to run: the dist/ bundle is committed to the repo. The only requirement is Node >= 22.5.

Related MCP server: Productivity Tracker MCP Server

Install (any MCP host)

Clone the repo and point your MCP host at the bundled server:

git clone https://github.com/sixfeetup/intervals-mcp.git

{
  "command": "node",
  "args": ["/path/to/intervals-mcp/dist/server.mjs"]
}

Configuration

Credentials and settings are resolved in this order:

Environment variables
config.json inside INTERVALS_HOME (or ~/.intervals/)

Environment variables

Variable	Description
`INTERVALS_API_KEY`	Intervals API key for HTTP Basic auth
`INTERVALS_BASE_URL`	Intervals API base URL (default: `https://api.myintervals.com/`)
`INTERVALS_PERSON_ID`	Your Intervals person ID (required for time-entry sync)
`INTERVALS_HOME`	Override the default local storage path (`~/.intervals/`)

`config.json` keys

If you prefer file-based configuration, create config.json inside INTERVALS_HOME (or ~/.intervals/):

Key	Type	Description
`apiKey`	`string`	Intervals API key for HTTP Basic auth
`baseUrl`	`string`	Intervals API base URL (default: `https://api.myintervals.com/`)
`personId`	`number`	Your Intervals person ID (required for time-entry sync)
`syncIntervalMs`	`number`	Background sync interval in milliseconds

Running intervals setup (or the /intervals-setup slash command) writes this file with 0600 permissions and never puts the API key in model context — the key is entered at an interactive, hidden prompt in your own terminal.

CLI

The bundle ships a zero-dependency CLI (dist/cli.mjs, exposed as intervals via package.json#bin when installed as a package):

Command	Description
`setup`	Configure credentials and run initial project sync
`status`	Show DB path, credential source, timers, pending sync
`sync-projects`	Refresh the local project catalog
`sync-now`	Push pending time entries to Intervals now
`timers [recent]` / `timers edit <timer_id> [field=value ...]` / `timers delete <timer_id>`	Show, edit, or delete timers
`time [range]` / `time edit <id> [field=value ...]`	Report time entries (`today`, `yesterday`, `this-week`, `last-week`, `this-month`, `last-month`, `YYYY-MM-DD`, `YYYY-MM-DD..YYYY-MM-DD`), or edit one (`stop_time=HH:mm` recalculates duration)
`project-defaults <project_id> <worktype_id> [module_id]`	Set project defaults

Run node dist/cli.mjs help (or intervals help) for the full usage text.

Agent tools

When installed as a Claude Code plugin, tools surface with the mcp__plugin_intervals_intervals__ prefix:

Tool	Description
`mcp__plugin_intervals_intervals__find_project_context`	Search the local project catalog for IDs and classifications (local-only)
`mcp__plugin_intervals_intervals__start_timer`	Start a local timer with a simple description and optional `start_at`; project/worktype/module are optional
`mcp__plugin_intervals_intervals__stop_timer`	Stop a timer, resolve classification, create a pending time entry, and sync
`mcp__plugin_intervals_intervals__edit_timer`	Update description or project/worktype/module hints on a running local timer
`mcp__plugin_intervals_intervals__delete_timer`	Safely delete an active timer or stopped timer with no linked time entry
`mcp__plugin_intervals_intervals__add_time`	Add a completed time entry directly (duration in minutes)
`mcp__plugin_intervals_intervals__edit_time`	Edit an existing local time entry by short ID or linked timer ID; use `stop_time` for local stop-time changes that recalculate duration
`mcp__plugin_intervals_intervals__delete_time`	Delete a local or synced time entry by short ID or linked timer ID
`mcp__plugin_intervals_intervals__query_time`	Report time entries by date range and project filter (local-only)
`mcp__plugin_intervals_intervals__list_timers`	List active or recent local timers
`mcp__plugin_intervals_intervals__lookup_time_entry`	Map a stopped local timer ID to the linked local time entry ID
`mcp__plugin_intervals_intervals__list_time`	List recent local time entries with sync status
`mcp__plugin_intervals_intervals__set_project_defaults`	Configure default worktype/module for a project
`mcp__plugin_intervals_intervals__sync_now`	Immediately retry syncing pending time entries to Intervals

mcp__plugin_intervals_intervals__start_timer accepts optional start_at values for retroactive local timer starts. Use HH:mm or H:mm for today in local time, YYYY-MM-DD HH:mm for a local date/time, or an ISO datetime with an explicit offset/timezone. Future start_at values are rejected.

Slash commands

Command	Description
`/intervals-setup`	Configure Intervals credentials and run the initial project sync
`/intervals-status`	Show Intervals DB path, credential source, active timers, pending sync, last project sync
`/intervals-sync-projects`	Refresh the local Intervals catalog of clients, projects, worktypes, and modules
`/intervals-sync-now`	Push pending local time entries to Intervals now
`/intervals-timers`	Show active or recent Intervals timers, or edit/delete a timer by ID
`/intervals-time`	Report local time entries by range, or edit an entry by ID
`/intervals-project-defaults`	Set the default worktype and optional module for a project

How it works

Timers are local-only. Starting a timer writes a lightweight local row with just a description. Project, worktype, and module hints are optional.
Running timers can be reclassified locally. Edit a timer's project, worktype, or module hints before stopping it; the updated classification is applied when the time entry is created.
Stop/apply creates a time entry. When you stop a timer, you provide (or resolve) the project and worktype. The server creates a pending time entry and immediately tries to sync it to Intervals.
Time entries are local-first. mcp__plugin_intervals_intervals__add_time, mcp__plugin_intervals_intervals__edit_time, and mcp__plugin_intervals_intervals__stop_timer all persist to SQLite before any network call. If sync fails, the entry stays local with a failed or pending status and can be retried.
Catalog sync stores active rows. Project sync fetches all catalog pages, keeps active projects and active classifications, and retains clients referenced by active projects.
Reports are local-only. mcp__plugin_intervals_intervals__query_time and /intervals-time read from SQLite and never call the Intervals API.

Developer note

If you open this repository itself in Claude Code, you may see the intervals MCP server listed as failed to connect. That's expected: the repo-root .mcp.json is the plugin's own configuration, and it references ${CLAUDE_PLUGIN_ROOT}, which is only set when the plugin is installed through /plugin install. Editing this repo's source doesn't install the plugin, so the variable is unset and the server can't start. It's safe to reject or ignore any prompt about it while working on the code.

This server cannot be installed

license - permissive license

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

Daily Work MCP Server
Note Taking File Systems Databases
hsgui
F
license
Not graded
quality
D
maintenance
Enables recording, querying, and summarizing daily work entries with tags using a local SQLite database. Supports work logging, search, timeline queries, tag management, and automated reminders for tracking daily tasks.
Updated 9 months ago (2025-11-27 05:41 UTC)
Productivity Tracker MCP
Note Taking Databases App Automation
manasamadgul
F
license
Not graded
quality
D
maintenance
Enables natural language task management including logging, updating, and summarizing productivity activities across multiple categories using a local SQLite database. It allows users to manage workflows and generate time-based summaries through standardized Model Context Protocol tools.
Updated 8 months ago (2025-12-11 00:43 UTC)
1
time-tracker-ai-mcp
Project Management Workplace & Productivity
CSOAI-ORG
A
license
A
quality
A
maintenance
Enables tracking work time with start/stop timers, logging entries, and generating reports.
Updated 2 months ago (2026-06-26 05:46 UTC)
4
8
MIT
MCP Project Bridge
Note Taking Documentation Access
Tenko-Star
A
license
Not graded
quality
B
maintenance
Enables multi-project workspaces to share structured notes, API contracts, and handoff messages via a local SQLite database, with versioning and read tracking.
Updated 2 months ago (2026-06-22 02:08 UTC)
GPL 3.0

View all related MCP servers

Related MCP Connectors

Timebook
Track time on usetimebook.com - start/stop timers, log entries, list projects/clients.
Business Days & SLA
Business-day, SLA, cron and recurrence calculations — offline, holiday-aware, no network.
ContextLattice
Private-by-default, local-first memory/context/task orchestrator for MCP apps and agents.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sixfeetup/intervals-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

intervals-mcp

Install (Claude Code plugin)

Install (any MCP host)

Configuration

Environment variables

config.json keys

CLI

Agent tools

Slash commands

How it works

Developer note

Maintenance

Resources

Looking for Admin?

Related MCP Servers

Daily Work MCP Server

Productivity Tracker MCP

time-tracker-ai-mcp

MCP Project Bridge

Related MCP Connectors

Latest Blog Posts

MCP directory API

`config.json` keys