Timetagger MCP

🚀 時間タグger MCPサーバー

このサーバーは、TimeTaggerとのやり取りを行うためのModel Context Protocol (MCP) サーバーです。Claudeやその他のMCP互換のAIアシスタントを通じて、時間記録の照会や管理を行うためのツールを提供します。

✨ 主な機能

• 特定の期間内で時間記録を照会する
• 新しい時間記録を作成する
• 既存の記録を更新する
• 記録を非表示/削除する
• タグで時間の要約を取得する
• タイマーを開始および停止する
• TimeTaggerの設定を管理する

📦 インストール

Claude Desktopへのインストール

以下の内容を claude_desktop_config.json ファイルに追加してください。

"timetagger": {
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/regismesquita/timetagger-mcp",
    "timetagger-mcp"
  ],
  "env": {
    "TIMETAGGER_API_KEY": "your-api-key-here",
    "TIMETAGGER_API_URL": "https://your-timetagger-instance.com/api/v2"
  }
}

手動インストール

1. uv がインストールされていることを確認してください。

   brew install uv
   

2. 必要な依存関係をインストールします。

   uv pip install -r requirements.txt
   

🔧 設定

サーバーは、TimeTagger APIキーを環境変数として設定する必要があります。

export TIMETAGGER_API_KEY="your-api-key-here"
export TIMETAGGER_API_URL="https://your-timetagger-instance.com/api/v2"

💻 使用例

開発モードでの実行

テストや開発に使用します。

fastmcp dev timetagger_mcp.py

これにより、MCPチェッカーインターフェースが起動し、ツールやリソースをテストできます。

Claude Desktopへのインストール

Claude Desktopと一緒に使用するには、以下のコマンドを実行します。

fastmcp install timetagger_mcp.py

利用可能なツール

• get_records(start_time, end_time): 特定の期間内の記録を取得する
• get_recent_records(hours): 過去N時間の記録を取得する
• get_today_records(): 当日の記録を取得する
• create_record(description, start_time, end_time): 新しい記録を作成する
• update_record(key, description, start_time, end_time): 既存の記録を更新する
• hide_record(key): 記録を非表示/削除する
• start_timer(description): 新しいタイマーを開始する
• stop_timer(key): 実行中のタイマーを停止する
• find_records_by_tag(tag, days): タグで記録を検索する
• get_time_summary(days): 過去N日間の時間の要約を取得する
• get_settings(): すべてのTimeTagger設定を取得する
• update_setting(key, value): 特定のTimeTagger設定を更新する

利用可能なリソース

• timetagger://config: TimeTaggerの設定を取得する
• timetagger://records/{timerange}: 特定の期間内の記録を取得する
• timetagger://settings: すべての設定を取得する
• timetagger://updates/{since}: 特定のタイムスタンプ以降の更新を取得する