ローカルファーストの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: time-tracker-ai-mcp
リポジトリをクローンし、バンドルされたサーバーを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 Basic認証用のIntervals APIキー |
| Intervals APIのベースURL（デフォルト: |
| あなたのIntervalsの人物ID（時間エントリ同期に必須） |
| デフォルトのローカルストレージパス（ |
config.jsonのキーファイルベースの設定を希望する場合は、INTERVALS_HOME（または~/.intervals/）内にconfig.jsonを作成してください:
キー | 型 | 説明 |
|
| HTTP Basic認証用の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と分類を検索（ローカルのみ） |
| シンプルな説明とオプションの |
| タイマーを停止し、分類を解決し、保留中の時間エントリを作成して同期 |
| 実行中のローカルタイマーの説明またはプロジェクト/ワークタイプ/モジュールのヒントを更新 |
| リンクされた時間エントリのないアクティブなタイマーまたは停止済みタイマーを安全に削除 |
| 完了した時間エントリを直接追加（分数で指定） |
| 短いIDまたはリンクされたタイマーIDで既存のローカル時間エントリを編集。ローカルの停止時刻変更には |
| 短いIDまたはリンクされたタイマーIDでローカルまたは同期済みの時間エントリを削除 |
| 日付範囲とプロジェクトフィルターで時間エントリをレポート（ローカルのみ） |
| アクティブまたは最近のローカルタイマーを一覧表示 |
| 停止したローカルタイマーIDをリンクされたローカル時間エントリIDにマッピング |
| 同期ステータス付きで最近のローカル時間エントリを一覧表示 |
| プロジェクトのデフォルトのワークタイプ/モジュールを設定 |
| 保留中の時間エントリの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カタログを更新 |
| 保留中のローカル時間エントリを今すぐIntervalsにプッシュ |
| アクティブまたは最近のIntervalsタイマーを表示、またはIDでタイマーを編集/削除 |
| 範囲でローカル時間エントリをレポート、またはIDでエントリを編集 |
| プロジェクトのデフォルトのワークタイプとオプションのモジュールを設定 |
タイマーはローカルのみ。 タイマーを開始すると、説明だけの軽量なローカル行が書き込まれます。プロジェクト、ワークタイプ、モジュールのヒントはオプションです。
実行中のタイマーはローカルで再分類可能。 停止する前にタイマーのプロジェクト、ワークタイプ、モジュールのヒントを編集できます。更新された分類は時間エントリ作成時に適用されます。
停止/適用で時間エントリが作成されます。 タイマーを停止すると、プロジェクトとワークタイプを指定（または解決）します。サーバーは保留中の時間エントリを作成し、すぐに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 deployed
Timer and time-tracking add-on: start/stop timers, log entries, CSV export. Data stays local.
Save and retrieve your chosen context, manage shared workspaces, and track project time.
Read time entries, projects, clients, tasks and invoices; log and update tracked time.
Privacy-first work tracking with summaries, reports, coaching, and AI-ready long-term memory.
