Timecamp MCP Server

🚀 TimeCamp MCP Server

This TimeCamp MCP Server offers seamless integration with TimeCamp, providing useful tools for managing time entries and tasks. It addresses key design choices and offers hosted and local deployment options.

✨ Features

• Language Choice: Opted for TypeScript (TS) over Python due to the official client, abundant materials, and support for Cloudflare Workers.
• Hosting Decision: Chose a hosted version for easier use, sparing users from installation.
• Platform Selection: Utilized Cloudflare Workers for their cost - effectiveness and simplicity.

The hosted version can be accessed at: https://my-mcp-server.timecamp-s-a.workers.dev

📚 Documentation

This MCP server provides the following tools for TimeCamp integration:

• add_timecamp_time_entry: Create a new time entry with start time, end time, note, and optional task.
• get_timecamp_time_entries: Retrieve time entries for a specified date range.
• get_timecamp_tasks: Fetch all available TimeCamp projects and tasks.
• delete_timecamp_time_entry: Delete a specific time entry by ID.
• update_timecamp_time_entry: Update an existing time entry (time, note, or task assignment).

💻 Usage Examples

Example prompt

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]

📦 Installation

Local

pnpm start

Deploy

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

Test

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

Connect Claude Desktop to your MCP server

You can also connect to your remote MCP server from local MCP clients, by using the mcp-remote proxy.

To connect to your MCP server from Claude Desktop, follow Anthropic's Quickstart and within Claude Desktop go to Settings > Developer > Edit Config.

Update with this configuration:

{
  "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>...."
      }
    }
  }
}

Restart Claude and you should see the tools become available.

⚠️ Important Note

If you have MacOS Claude Desktop - 'Server transport closed unexpectedly' see https://github.com/modelcontextprotocol/servers/issues/1748#issuecomment-2896004925.

🔧 Technical Details

Not yet implemented

• Oauth authorization (https://github.com/huanshenyi/mcp-server-bearer-auth/tree/main)
• Problem with MCP using URL in Cursor after fixing problem with Cloudflare workers not using received authorization header