Skip to main content
Glama
enesjakozh
markpitt

FreeAgent MCP Server

by markpitt
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

FreeAgent MCP サーバー

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

ライセンス: MIT

特徴

  • ネストされたデータを含むタイムスリップの一覧表示とフィルタリング

  • 新しいタイムスリップを作成する

  • 既存のタイムスリップを更新する

  • タイマーの開始と停止

  • タイムスリップを削除する

  • OAuthトークンの自動更新

  • 包括的なエラー処理

  • Dockerサポート

Related MCP server: Beebole MCP

前提条件

  • Node.js 18+ (Node.js を直接使用する場合)

  • Docker と Docker Compose (コンテナ化して使用する場合)

  • APIアクセス可能なFreeAgentアカウント

  • FreeAgent 開発者ダッシュボードからの OAuth 認証情報

インストール

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

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

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

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

npm install

  1. 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のインストール

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

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

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

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

  1. 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 .

貢献

  1. リポジトリをフォークする

  2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）

  3. 変更をコミットします ( git commit -am 'Add some amazing feature' )

  4. ブランチにプッシュする ( git push origin feature/amazing-feature )

  5. プルリクエストを開く

ライセンス

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

謝辞

  • 優れたAPIドキュメントを提供するFreeAgent

  • MCP SDKのClaudeチーム

Install Server
A
license - permissive license
A
quality
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • Work-Timer

    JoelBondoux
    A
    license
    -
    quality
    D
    maintenance
    An MCP server for time tracking and billing that allows freelancers to control timers, manage projects, and export invoices via natural language in any MCP-compatible AI assistant.
    5
    MIT

  • freshbooks-mcp-server

    bitovi
    F
    license
    -
    quality
    A
    maintenance
    An MCP server that connects Claude to FreshBooks, enabling reading and management of invoices, clients, expenses, projects, and time entries via natural language.
    1

View all related MCP servers

Related MCP Connectors

  • agentcentral

    Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.

  • mcp

    Augments MCP Server - A comprehensive framework documentation provider for Claude Code

  • Remote Desktop Commander

    Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/markpitt/freeagent-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server