Intervals 시간 추적을 위한 독립형 MCP 서버, CLI, Claude Code 플러그인입니다. 타이머를 시작하거나 시간 항목을 기록하면 먼저 로컬 SQLite 데이터베이스에 저장되고, 항목은 백그라운드에서 또는 요청 시 Intervals에 동기화됩니다. 보고서와 조회는 항상 로컬 전용이며 Intervals API를 호출하지 않습니다.
/plugin marketplace add sixfeetup/intervals-mcp
/plugin install intervals@intervals-mcp빌드 단계가 필요 없습니다. dist/ 번들은 저장소에 커밋되어 있습니다.
요구 사항은 Node 22.5 이상뿐입니다.
Related MCP server: Productivity Tracker MCP Server
저장소를 클론하고 MCP 호스트가 번들 서버를 가리키도록 설정하세요:
git clone https://github.com/sixfeetup/intervals-mcp.git{
"command": "node",
"args": ["/path/to/intervals-mcp/dist/server.mjs"]
}자격 증명과 설정은 다음 순서로 확인됩니다:
환경 변수
INTERVALS_HOME(또는 ~/.intervals/) 안의 config.json
변수 | 설명 |
| HTTP 기본 인증용 Intervals API 키 |
| Intervals API 기본 URL (기본값: |
| 사용자 Intervals 개인 ID (시간 항목 동기화에 필요) |
| 기본 로컬 저장 경로 재정의 ( |
config.json 키파일 기반 구성을 선호한다면 INTERVALS_HOME(또는 ~/.intervals/) 안에 config.json을 만드세요:
키 | 유형 | 설명 |
|
| HTTP 기본 인증용 Intervals API 키 |
|
| Intervals API 기본 URL (기본값: |
|
| 사용자 Intervals 개인 ID (시간 항목 동기화에 필요) |
|
| 백그라운드 동기화 간격(밀리초) |
intervals setup(또는 /intervals-setup 슬래시 명령)을 실행하면
이 파일이 0600 권한으로 작성되며 API 키가 모델
컨텍스트에 노출되지 않습니다. 키는 사용자 터미널의 대화형
숨김 프롬프트에서 입력됩니다.
번들은 의존성이 없는 CLI(dist/cli.mjs)를 제공하며, 패키지로 설치하면
package.json#bin을 통해 intervals로 노출됩니다:
명령 | 설명 |
| 자격 증명 구성 및 초기 프로젝트 동기화 실행 |
| DB 경로, 자격 증명 소스, 타이머, 대기 중인 동기화 표시 |
| 로컬 프로젝트 카탈로그 새로 고침 |
| 대기 중인 시간 항목을 지금 Intervals로 푸시 |
| 타이머 표시, 편집 또는 삭제 |
| 시간 항목 보고 ( |
| 프로젝트 기본값 설정 |
전체 사용법은 node dist/cli.mjs help(또는 intervals help)를 실행하세요.
Claude Code 플러그인으로 설치하면 도구는 mcp__plugin_intervals_intervals__ 접두사로 노출됩니다:
도구 | 설명 |
| 로컬 프로젝트 카탈로그에서 ID 및 분류 검색 (로컬 전용) |
| 간단한 설명과 선택적 |
| 타이머 중지, 분류 확인, 대기 중인 시간 항목 생성 및 동기화 |
| 실행 중인 로컬 타이머의 설명 또는 project/worktype/module 힌트 업데이트 |
| 활성 타이머 또는 연결된 시간 항목이 없는 중지된 타이머 안전 삭제 |
| 완료된 시간 항목 직접 추가 (기간(분) 단위) |
| 짧은 ID 또는 연결된 타이머 ID로 기존 로컬 시간 항목 편집; |
| 짧은 ID 또는 연결된 타이머 ID로 로컬 또는 동기화된 시간 항목 삭제 |
| 날짜 범위 및 프로젝트 필터로 시간 항목 보고 (로컬 전용) |
| 활성 또는 최근 로컬 타이머 나열 |
| 중지된 로컬 타이머 ID를 연결된 시간 항목 ID에 매핑 |
| 동기화 상태와 함께 최근 로컬 시간 항목 나열 |
| 프로젝트의 기본 worktype 및 선택적 module 구성 |
| 대기 중인 시간 항목을 Intervals로 즉시 재동기화 |
mcp__plugin_intervals_intervals__start_timer는 소급 시작을 위해 선택적 start_at 값을 허용합니다.
오늘 날짜의 로컬 시간은 HH:mm 또는 H:mm 형식을 사용하고,
로컬 날짜/시간은 YYYY-MM-DD HH:mm 형식을 사용하며,
명시적 오프셋/시간대가 있는 ISO 날짜/시간도 허용됩니다.
미래의 start_at 값은 거부됩니다.
명령 | 설명 |
| Intervals 자격 증명 구성 및 초기 프로젝트 동기화 실행 |
| Intervals DB 경로, 자격 증명 소스, 활성 타이머, 대기 중인 동기화, 마지막 프로젝트 동기화 표시 |
| 로컬 Intervals 클라이언트, 프로젝트, worktype, module 카탈로그 새로 고침 |
| 대기 중인 로컬 시간 항목을 지금 Intervals로 푸시 |
| 활성 또는 최근 Intervals 타이머 표시, 또는 ID로 타이머 편집/삭제 |
| 범위별 로컬 시간 항목 보고, 또는 ID로 항목 편집 |
| 프로젝트의 기본 worktype 및 선택적 module 설정 |
타이머는 로컬 전용입니다. 타이머를 시작하면 설명만 포함된 가벼운 로컬 행이 작성됩니다. 프로젝트, worktype, module 힌트는 선택 사항입니다.
실행 중인 타이머는 로컬에서 재분류할 수 있습니다. 타이머를 중지하기 전에 프로젝트, worktype, module 힌트를 편집할 수 있으며, 업데이트된 분류는 시간 항목이 생성될 때 적용됩니다.
중지/적용 시 시간 항목이 생성됩니다. 타이머를 중지하면 프로젝트와 worktype을 제공(또는 확인)합니다. 서버는 대기 중인 시간 항목을 생성하고 즉시 Intervals에 동기화를 시도합니다.
시간 항목은 로컬 우선입니다. mcp__plugin_intervals_intervals__add_time,
mcp__plugin_intervals_intervals__edit_time, mcp__plugin_intervals_intervals__stop_timer는 모두
네트워크 호출 전에 SQLite에 저장합니다. 동기화에 실패하면 항목은
failed 또는 pending 상태로 로컬에 남아 재시도할 수 있습니다.
카탈로그 동기화는 활성 행을 저장합니다. 프로젝트 동기화는 모든 카탈로그 페이지를 가져오고, 활성 프로젝트와 활성 분류를 유지하며, 활성 프로젝트가 참조하는 클라이언트를 보관합니다.
보고서는 로컬 전용입니다. mcp__plugin_intervals_intervals__query_time 및 /intervals-time은 SQLite에서
읽으며 Intervals API를 호출하지 않습니다.
Claude Code에서 이 저장소 자체를 열면 intervals
MCP 서버가 연결 실패로 표시될 수 있습니다. 이는 정상입니다. 저장소 루트의
.mcp.json은 플러그인 자체 구성이며, 이는
${CLAUDE_PLUGIN_ROOT}를 참조하는데, 이 변수는 플러그인이
/plugin install을 통해 설치된 경우에만 설정됩니다. 이 저장소의 소스를 편집해도
플러그인이 설치되지 않으므로 변수가 설정되지 않아 서버가 시작할 수 없습니다.
코드를 작업하는 동안 이와 관련된 프롬프트가 표시되면 거부하거나 무시해도 안전합니다.
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Track time on usetimebook.com - start/stop timers, log entries, list projects/clients.
Business-day, SLA, cron and recurrence calculations — offline, holiday-aware, no network.
Private-by-default, local-first memory/context/task orchestrator for MCP apps and agents.
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