timecamp-mcp-server
This is no longer maitaned
Documentation
> [!CAUTION]
> It's not longer maitaned. Please use our official MCP https://docs.timecamp.com/mcp-server
>
> Developers building their own MCP server can still use this repository as a template or starting point.
TimeCamp MCP Server
- Why TS not Python? Official client, more materials, support for Cloudflare workers.
- Why hosted and not local only? Easier to use, users don't need to install it.
- Why Cloudflare Workers? Cheap & easy.
Hosted version is available at: https://my-mcp-server.timecamp-s-a.workers.dev
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)
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]Setup & run
Local
pnpm startDeploy
pnpm dlx wrangler@latest deploy
pnpm dlx wrangler@latest tailTest
npx mcp-remote http://localhost:8787/sse --header "Authorization: Bearer "
npx mcp-remote https://my-mcp-server.timecamp-s-a.workers.dev/sse --header "Authorization: Bearer "
pnpm dlx @modelcontextprotocol/inspector@latestConnect 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 "
}
},
"timecamp_url": { // if MCP client supports url
"url": "https://my-mcp-server.timecamp-s-a.workers.dev/sse",
"headers": {
"Authorization": "Bearer ...."
}
},
}
}Restart Claude and you should see the tools become available.
If you have MacOS Claude Desktop - 'Server transport closed unexpectedly' see https://github.com/modelcontextprotocol/servers/issues/1748#issuecomment-2896004925.
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
Frequently asked questions
What is timecamp-mcp-server?
timecamp-mcp-server is This is no longer maitaned
How do I install timecamp-mcp-server?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is timecamp-mcp-server open source?
Yes — it is hosted on GitHub at https://github.com/timecamp-org/timecamp-mcp-server and has 1 stars.
Related MCP tools
The Open-Source Multimodal AI Agent Stack: Connecting Cutting-Edge AI Models and Agent Infra
A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you
Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
The go-to web for your AI coding agent — local-first search, fetch, crawl & research over MCP. No API keys, no cloud, $0/query. Public beta.
MCP Aggregator, Orchestrator, Middleware, Gateway in one docker
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP