FreeAgent MCP サーバー

FreeAgentのタイムスリップとタイマーを管理するためのClaude MCP（Model Context Protocol）サーバー。このサーバーにより、ClaudeはFreeAgentアカウントと連携して、時間を追跡し、タイマーを管理し、タイムスリップの操作を処理できます。

特徴

ネストされたデータを含むタイムスリップの一覧表示とフィルタリング
新しいタイムスリップを作成する
既存のタイムスリップを更新する
タイマーの開始と停止
タイムスリップを削除する
OAuthトークンの自動更新
包括的なエラー処理
Dockerサポート

前提条件

Node.js 18+ (Node.js を直接使用する場合)
Docker と Docker Compose (コンテナ化して使用する場合)
APIアクセス可能なFreeAgentアカウント
FreeAgent 開発者ダッシュボードからの OAuth 認証情報

インストール

オプション1: Node.jsの直接インストール

リポジトリをクローンします。

git clone https://github.com/yourusername/freeagent-mcp.git
cd freeagent-mcp

依存関係をインストールします:

npm install

OAuth トークンを取得します。

# Set your FreeAgent credentials
export FREEAGENT_CLIENT_ID="your_client_id"
export FREEAGENT_CLIENT_SECRET="your_client_secret"

# Run the OAuth setup script
node scripts/get-oauth-tokens.js

オプション2: Dockerのインストール

リポジトリをクローンします。

git clone https://github.com/yourusername/freeagent-mcp.git
cd freeagent-mcp

環境ファイルを作成します。

cp .env.example .env
# Edit .env with your FreeAgent credentials

Docker イメージをビルドします。

docker build -t freeagent-mcp .

構成

サーバーを MCP 設定に追加します (通常は%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonにあります)。

Node.js のインストールの場合:

{
  "mcpServers": {
    "freeagent": {
      "command": "node",
      "args": ["path/to/freeagent-mcp/build/index.js"],
      "env": {
        "FREEAGENT_CLIENT_ID": "your_client_id",
        "FREEAGENT_CLIENT_SECRET": "your_client_secret",
        "FREEAGENT_ACCESS_TOKEN": "your_access_token",
        "FREEAGENT_REFRESH_TOKEN": "your_refresh_token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Docker インストールの場合:

{
  "mcpServers": {
    "freeagent": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "FREEAGENT_CLIENT_ID",
        "-e", "FREEAGENT_CLIENT_SECRET",
        "-e", "FREEAGENT_ACCESS_TOKEN",
        "-e", "FREEAGENT_REFRESH_TOKEN",
        "freeagent-mcp"
      ],
      "env": {
        "FREEAGENT_CLIENT_ID": "your_client_id",
        "FREEAGENT_CLIENT_SECRET": "your_client_secret",
        "FREEAGENT_ACCESS_TOKEN": "your_access_token",
        "FREEAGENT_REFRESH_TOKEN": "your_refresh_token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

使用法

設定が完了すると、Claude は次のツールを使用できるようになります。

タイムスリップ一覧

{
  "from_date": "2024-01-01",      // Start date (YYYY-MM-DD)
  "to_date": "2024-03-04",        // End date (YYYY-MM-DD)
  "updated_since": "2024-03-04T12:00:00Z",  // ISO datetime
  "view": "all",                  // "all", "unbilled", or "running"
  "user": "https://api.freeagent.com/v2/users/123",
  "task": "https://api.freeagent.com/v2/tasks/456",
  "project": "https://api.freeagent.com/v2/projects/789",
  "nested": true                  // Include nested resources
}

タイムスリップを作成

{
  "task": "https://api.freeagent.com/v2/tasks/123",
  "user": "https://api.freeagent.com/v2/users/456",
  "project": "https://api.freeagent.com/v2/projects/789",
  "dated_on": "2024-03-04",
  "hours": "1.5",
  "comment": "Optional comment"
}

タイマーコントロール

// Start timer
{
  "id": "123"
}

// Stop timer
{
  "id": "123"
}

発達

Node.js開発

# Build the project
npm run build

# Watch for changes
npm run watch

# Run tests (when implemented)
npm test

Docker開発

# Build the Docker image
docker build -t freeagent-mcp .

貢献

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットします ( git commit -am 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

謝辞

優れたAPIドキュメントを提供するFreeAgent
MCP SDKのClaudeチーム

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Claude が FreeAgent アカウントと対話して時間を追跡し、タイマーを管理し、タイムスリップ操作を処理できるようにする Claude MCP サーバー。

Related Resources

Reddit Discussion about this server

Related MCP Servers

ticktick-mcp-server
jacepark12
-
security
F
license
-
quality
A MCP server for TickTick that enables interacting with your TickTick task management system directly through Claude and other MCP clients.
Last updated -
106
Python
Port MCP Server
port-labs
-
security
A
license
-
quality
An MCP server that enables Claude to interact with Port.io's AI agent, allowing users to trigger the agent with prompts and receive structured responses including status, output, and action items.
Last updated -
12
Python
MIT License
MCP Claude Code
SDGLBL
-
security
A
license
-
quality
An MCP server that implements Claude Code-like functionality, allowing the AI to analyze codebases, modify files, execute commands, and manage projects through direct file system interactions.
Last updated -
229
Python
MIT License
Union MCP
unionai-oss
-
security
A
license
-
quality
An MCP server that allows Claude models to use Union tasks, workflows, and apps as tools in conversations.
Last updated -
5
Python
Apache 2.0

View all related MCP servers

FreeAgent MCP Server