Timebutler MCP by usefulapi

usefulapi の Timebutler MCP

Claude、Cursor、または任意の MCP クライアントから、Timebutler アカウントを利用できます。休暇、勤務時間の記録、休暇残数を読み取り、マネージャーの場合はチームの申請も確認できます。また、タイムレコーダーの開始・停止や休暇の申請も行えます。ホスト型のためローカルへのインストールは不要です。ご自身の認証情報を使って接続します。

ライブエンドポイント： https://timebutler.usefulapi.io/mcp · ホームページ： https://usefulapi.io

接続

• Claude（claude.ai、デスクトップ）：Customize → Connectorsを開き、+ Add → Add custom connectorをクリックして、https://timebutler.usefulapi.io/mcpを貼り付けます。
• Claude Code： claude mcp add --transport http timebutler https://timebutler.usefulapi.io/mcpを実行し、続けて/mcpを実行してログインします。
• VS Code： VS Code に追加。
• Cursor およびその他のクライアント： URL をリモート MCP サーバーとして追加します。

{
  "mcpServers": {
    "timebutler": {
      "url": "https://timebutler.usefulapi.io/mcp"
    }
  }
}

URL のみを追加してください。クライアント設定にAuthorizationヘッダーや API キーを追加しないでください。サーバーは OAuth でログインし、ログインページで Timebutler の認証情報を求めます。

詳しいセットアップ手順、認証情報の確認場所、よくある質問はこちら：https://usefulapi.io/timebutler/

初回接続時に、Timebutler の個人用アクセストークンを入力します（トークンは tb_ で始まります。Timebutler アカウント設定の個人用アクセストークンから作成してください）。サーバーがトークンを検証し、ユーザーごとに保存します。設定ファイルにキーを記載する必要はありません。

ツール

ツール	種類	内容
timebutler_get_profile	read	自分のプロフィールを取得
timebutler_list_employees	read	従業員一覧を取得
timebutler_list_absence_types	read	休暇の種類一覧を取得
timebutler_list_categories	read	勤務時間カテゴリ一覧を取得
timebutler_list_projects	read	プロジェクト一覧を取得
timebutler_list_my_absence_requests	read	自分の休暇申請一覧を取得
timebutler_list_team_absence_requests	read	チームの休暇申請一覧を取得
timebutler_get_absence_pending_count	read	未処理の休暇申請数を取得
timebutler_list_my_time_entries	read	自分の勤務時間記録一覧を取得
timebutler_get_time_entry_pending_count	read	未処理の勤務時間記録数を取得
timebutler_list_time_entry_requests	read	勤務時間記録の申請一覧を取得
timebutler_get_time_clock_status	read	タイムレコーダーの状態を取得
timebutler_get_work_summary	read	本日の勤務概要を取得
timebutler_get_time_off_summary	read	休暇の概要を取得
timebutler_clock_start	write	タイムレコーダーを開始
timebutler_clock_pause	write	タイムレコーダーを一時停止
timebutler_clock_resume	write	タイムレコーダーを再開
timebutler_clock_stop	write	タイムレコーダーを停止して保存
timebutler_submit_clock_entry	write	完了した勤務時間記録を送信
timebutler_create_absence_request	write	休暇を申請
timebutler_usage_status	meta	利用状況（無料プランの使用量）
timebutler_request_feature	meta	不足している機能をリクエスト
timebutler_upgrade	meta	Pro にアップグレード（無制限*）
timebutler_cancel_subscription	meta	Pro サブスクリプションを解約

readツールは読み取り専用です。writeツールはデータを変更するため、クライアントは実行前に確認する必要があります。metaツールは利用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。

料金

プラン	価格	上限
無料	$0	月50回のツール呼び出し
Pro（ユーザーごと）	$9/mo または $90/yr（2か月分無料）	無制限*

*Pro には、このサーバーで月10,000回のツール呼び出しという公正利用上限があります。これを超える場合は、[email protected] までお問い合わせください。

Pro はこのサーバーのみが対象です。timebutler_upgrade で申し込むと、Stripe Checkout のリンクが返されます。timebutler_cancel_subscription でいつでも解約できます。Pro は支払い済み期間の終了まで利用でき、現在の期間分の返金はありません。終了前に timebutler_upgrade を実行すると、解約が取り消されます。または [email protected] までお問い合わせください。

ライセンス

MIT — LICENSE をご覧ください。ドキュメントのみです。サーバーはホストされています。