Timecamp MCP Server

🚀 TimeCamp MCP Server

TimeCamp MCP Serverは、TimeCampとの統合を支援するツールを提供するサーバーです。TypeScriptを使用し、Cloudflare Workers上でホストされており、使いやすさと低コストを実現しています。

選択理由

• なぜTypeScriptを使用したのか：公式クライアントがあり、関連資料が豊富で、Cloudflare Workersをサポートしているため。
• なぜホスト型なのか：ユーザーがインストールする必要がなく、使いやすいため。
• なぜCloudflare Workersを選んだのか：安価で簡単に利用できるため。

ホスト版はこちらから利用可能です: https://my-mcp-server.timecamp-s-a.workers.dev

🚀 クイックスタート

このMCPサーバーが提供するTimeCamp統合ツール

• add_timecamp_time_entry - 開始時間、終了時間、メモ、およびオプションのタスクを指定して、新しいタイムエントリを作成します。
• get_timecamp_time_entries - 指定された日付範囲のタイムエントリを取得します。
• get_timecamp_tasks - 利用可能なすべてのTimeCampプロジェクトとタスクを取得します。
• delete_timecamp_time_entry - IDで特定のタイムエントリを削除します。
• update_timecamp_time_entry - 既存のタイムエントリの時間、メモ、またはタスク割り当てを更新します。

💻 使用例

基本的な使用法

Create Timecamp time entries based on these tasks I did. 
I write tasks by putting -HH:MM, which is the end time for the task, so each time entry should take from end end time of previous entry.
Try to match timecamp task, so first you have to fetch my timecamp tasks.
Note should be single sentence in English with 3-12 words.
Ignore "[minutes:: ...]" as this is estimate.

- [x] -9:43 emails & org [completion:: 2025-06-21]
- [x] -12:10 #tech new version of reports [[(project) XYZ]] [completion:: 2025-06-21]
- [x] -12:58 (evening) Buy shoes + relax [completion:: 2025-06-21] 
- [x] -14:30 relax [completion:: 2025-06-21]
- [x] -15:30 #tech Notifications still not working for one more person from our group [completion:: 2025-06-21]
- [x] -15:40 I don't remember [completion:: 2025-06-21] 
- [x] -17:09 #tech Client - database connection problem [[(process) Technical support]] [minutes:: 15] [completion:: 2025-06-21]
- [x] -17:35 break [completion:: 2025-06-21]
- [x] -19:17 #tech Client [[(project) Client]] [[(process) Technical support]] [minutes:: 10] [completion:: 2025-06-21]	- - [x] -19:21 (evening) Fill timesheet [completion:: 2025-06-21]

📦 インストール

ローカルでの実行

pnpm start

デプロイ

pnpm dlx wrangler@latest deploy
pnpm dlx wrangler@latest tail

テスト

npx mcp-remote http://localhost:8787/sse --header "Authorization: Bearer <api_token>"
npx mcp-remote https://my-mcp-server.timecamp-s-a.workers.dev/sse --header "Authorization: Bearer <api_token>"
pnpm dlx @modelcontextprotocol/inspector@latest

📚 ドキュメント

Claude DesktopをMCPサーバーに接続する方法

mcp-remote proxyを使用することで、ローカルのMCPクライアントからリモートのMCPサーバーに接続できます。

Claude DesktopからMCPサーバーに接続するには、Anthropic's Quickstartに従い、Claude Desktop内で設定 > 開発者 > 設定の編集に移動します。

以下の設定で更新します:

{
  "mcpServers": {
    "timecamp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://my-mcp-server.timecamp-s-a.workers.dev/sse", // or http://localhost:8787/sse
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <auth-token>"
      }
    },
    "timecamp_url": { // if MCP client supports url
      "url": "https://my-mcp-server.timecamp-s-a.workers.dev/sse",
      "headers": {
        "Authorization": "Bearer <auth-token>...."
      }
    }
  }
}

Claudeを再起動すると、ツールが利用可能になります。

MacOSのClaude Desktopで 'Server transport closed unexpectedly' というエラーが表示される場合は、https://github.com/modelcontextprotocol/servers/issues/1748#issuecomment-2896004925 を参照してください。

🔧 未実装の機能

• Oauth認証 (https://github.com/huanshenyi/mcp-server-bearer-auth/tree/main)
• Cloudflare Workersが受信した認証ヘッダーを使用しない問題を修正した後、CursorでURLを使用するMCPの問題