Toggl MCP Server

阅读此文档的语言版本：英文 | 日语

<a id="english"></a>

英文

概述

Toggl MCP Server 是一个模型上下文协议（MCP）服务器，允许AI助手与Toggl时间跟踪API进行交互。这使得AI助手能够通过自然语言直接管理Toggl中的时间条目、项目和工作区。

功能

• 带过滤选项的时间条目获取
• 创建新的时间条目
• 更新现有时间条目
• 删除时间条目
• 获取当前运行的时间条目
• 停止运行的时间条目
• 获取工作区信息
• 获取工作区内的项目
• 多平台支持（linux/amd64, linux/arm64）

使用方法

MCP配置

要将AI助手连接到此服务器，请在您的.cursor/mcp.json文件中配置MCP连接：

{
  "mcpServers": {
    "toggl-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TOGGL_API_TOKEN",
        "lyricrime/toggl-mcp-server"
      ],
      "env": {
        "TOGGL_API_TOKEN": "your_toggl_api_token"
      }
    }
  }
}

配置完成后，您的AI助手可以通过自然语言命令直接与Toggl交互。

环境变量

• TOGGL_API_TOKEN（必需）：用于认证的Toggl API令牌

许可证

MIT许可证

---

<a id="japanese"></a>

日语

概要

Toggl MCP Serverは、AIアシスタントがTogglのタイム・トラッキングAPIと対話できるようにするModel Context Protocol (MCP)サーバーです。これにより、AIアシスタントは自然言語を通じてTogglのタイムエントリー、プロジェクト、ワークスペースを直接管理できるようになります。

機能

• フィルタリングオプション付きのタイムエントリー取得
• 新規タイムエントリーの作成
• 既存タイムエントリーの更新
• タイムエントリーの削除
• 現在実行中のタイムエントリーの取得
• 実行中のタイムエントリーの停止
• ワークスペース情報の取得
• ワークスペース内のプロジェクト取得
• マルチプラットフォームサポート（linux/amd64, linux/arm64）

使用方法

MCP設定

AIアシスタントをこのサーバーに接続するには、.cursor/mcp.jsonファイルにMCP接続を以下のように設定します：

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

設定が完了すれば、AIアシスタントは自然言語コマンドを通じて直接Togglと対話できるようになります。

環境変数

• TOGGL_API_TOKEN（必須）：認証用のToggl APIトークン

ライセンス

MITライセンス