Toggl MCP Server

🚀 Toggl MCP サーバ

Toggl MCP サーバは、AI アシスタントが自然言語で Toggl 時間追跡 API と対話できるようにする、モデルコンテキストプロトコル（MCP）サーバです。これにより、AI アシスタントは Toggl 内の時間エントリ、プロジェクト、ワークスペースを直接管理できます。

🚀 クイックスタート

Toggl MCP サーバを使用することで、AI アシスタントが自然言語で Toggl 時間追跡 API とやり取りできるようになります。以下の手順に従って、サーバを設定してください。

✨ 主な機能

• フィルタオプション付きで時間エントリを取得
• 新しい時間エントリを作成
• 既存の時間エントリを更新
• 時間エントリを削除
• 現在実行中の時間エントリを取得
• 実行中の時間エントリを停止
• ワークスペース情報を取得
• ワークスペース内のプロジェクトを取得
• マルチプラットフォーム対応（linux/amd64、linux/arm64）

💻 使用例

基本的な使用法

{
  "mcpServers": {
    "toggl-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TOGGL_API_TOKEN",
        "lyricrime/toggl-mcp-server"
      ],
      "env": {
        "TOGGL_API_TOKEN": "あなたのTogglAPIトークン"
      }
    }
  }
}

上記のコードを .cursor/mcp.json ファイルに記述することで、AI アシスタントを Toggl MCP サーバに接続できます。

高度な使用法

{
  "mcpServers": {
    "toggl-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TOGGL_API_TOKEN",
        "lyricrime/toggl-mcp-server"
      ],
      "env": {
        "TOGGL_API_TOKEN": "あなたのTogglAPIトークン"
      }
    }
  }
}

このコードでは、基本的な使用法と同じ設定を行っていますが、TOGGL_API_TOKEN を適切に設定することで、AI アシスタントが Toggl API と安全に通信できます。

📚 ドキュメント

環境変数

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。