{"id":49575105,"url":"https://github.com/rollecode/timely-mcp-server","last_synced_at":"2026-05-03T16:10:51.644Z","repository":{"id":342616504,"uuid":"1174572887","full_name":"rollecode/timely-mcp-server","owner":"rollecode","description":"MCP server for time tracking API. Connects Claude Code (or any MCP client) to your Timely account for reading and creating time entries, projcts, tasks, and users.","archived":false,"fork":false,"pushed_at":"2026-03-06T16:18:59.000Z","size":30,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-02T13:33:34.387Z","etag":null,"topics":["ai","ai-agents","api","claude-code","mcp","mcp-api","mcp-client","mcp-clients","mcp-gateway","mcp-server","mcp-tools","timely","timelyapp"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rollecode.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-06T15:43:51.000Z","updated_at":"2026-03-06T18:14:11.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/rollecode/timely-mcp-server","commit_stats":null,"previous_names":["ronilaukkarinen/timely-mcp-server","rollecode/timely-mcp-server"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/rollecode/timely-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollecode%2Ftimely-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollecode%2Ftimely-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollecode%2Ftimely-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollecode%2Ftimely-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rollecode","download_url":"https://codeload.github.com/rollecode/timely-mcp-server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rollecode%2Ftimely-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32575387,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agents","api","claude-code","mcp","mcp-api","mcp-client","mcp-clients","mcp-gateway","mcp-server","mcp-tools","timely","timelyapp"],"created_at":"2026-05-03T16:10:50.983Z","updated_at":"2026-05-03T16:10:51.639Z","avatar_url":"https://github.com/rollecode.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ccenter align=\"center\" style=\"text-align: center;justify-content:center;\"\u003e\n\u003cdiv align=\"center\" style=\"text-align: center;justify-content:center;\"\u003e\n\u003ch1 align=\"center\" style=\"text-align: center;justify-content:center;\"\u003e\n\nTimely MCP server\n  \n\u003cimg style=\"justify-content:center;text-align: center;width: 95px; height: auto;\" width=\"793\" height=\"411\" alt=\"image\" src=\"https://github.com/user-attachments/assets/abed1a04-d69b-4ab4-a490-d606064df72d\" /\u003e\n\u003cimg style=\"justify-content:center;text-align: center;width: 210px; height: auto;\" width=\"756\" height=\"206\" alt=\"image\" src=\"https://github.com/user-attachments/assets/f3aea4cc-1c05-4574-be39-0949b02eae70\" /\u003e\n  \n\u003c/h1\u003e\n\n![Version](https://img.shields.io/badge/version-1.0.0-blue.svg?style=for-the-badge) ![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge\u0026logo=typescript\u0026logoColor=white) ![Bun](https://img.shields.io/badge/Bun-000000?style=for-the-badge\u0026logo=bun\u0026logoColor=white)\n\n\u003c/div\u003e\n\u003c/center\u003e\n\n\u003chr\u003e\n\nMCP server for [Timely](https://timelyapp.com) time tracking API. Connects Claude Code (or any MCP client) to your Timely account for reading and creating time entries, projects, tasks, and users.\n\n\u003chr\u003e\n\n\u003cimg width=\"803\" height=\"340\" alt=\"image\" src=\"https://github.com/user-attachments/assets/553167df-0758-49db-a899-d1f6c4b13679\" /\u003e\n\n\n## Features\n\n- Read and create time entries with labels/tags\n- Browse projects, users, and tasks\n- Auto-refreshes expired OAuth tokens\n- Auto-detects account ID during setup\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `timely_me` | Current user info |\n| `timely_list_projects` / `timely_get_project` | Projects |\n| `timely_list_users` / `timely_get_user` | People |\n| `timely_list_events` / `timely_get_event` | Time entries (filterable by date, user, project) |\n| `timely_create_event` / `timely_update_event` / `timely_delete_event` | Manage time entries |\n| `timely_list_labels` / `timely_get_label` | Labels/tags |\n| `timely_list_tasks` / `timely_get_task` | Tasks/forecasts |\n\n## Setup\n\n### 1. Create a Timely OAuth app\n\nGo to `https://app.timelyapp.com/\u003cyour-account-id\u003e/oauth_applications` and create a new app with redirect URI `https://localhost:7890/callback`.\n\n### 2. Configure\n\n```bash\ncp .env.example .env\n```\n\nAdd `TIMELY_CLIENT_ID` and `TIMELY_CLIENT_SECRET` from the OAuth app.\n\n### 3. Authenticate\n\n```bash\nbun install\nbun auth.ts\n```\n\nOpen the URL in your browser and authorize. Tokens and account ID are saved automatically.\n\n### 4. Add to Claude Code\n\n```bash\nclaude mcp add timely --transport stdio --scope user \\\n  -- bun /path/to/timely-mcp-server/server.ts\n```\n\n### 5. Verify\n\nIn Claude Code, run `/mcp` and check that `timely` shows as connected.\n\n## Token refresh\n\nThe server auto-refreshes expired access tokens. No manual re-auth needed unless the refresh token is revoked.\n\n## Requirements\n\n- [Bun](https://bun.sh) runtime\n- Timely account with API access\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frollecode%2Ftimely-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frollecode%2Ftimely-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frollecode%2Ftimely-mcp-server/lists"}