https://github.com/rollecode/timely-mcp-server
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.
https://github.com/rollecode/timely-mcp-server
ai ai-agents api claude-code mcp mcp-api mcp-client mcp-clients mcp-gateway mcp-server mcp-tools timely timelyapp
Last synced: 27 days ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/rollecode/timely-mcp-server
- Owner: rollecode
- Created: 2026-03-06T15:43:51.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2026-03-06T16:18:59.000Z (3 months ago)
- Last Synced: 2026-05-02T13:33:34.387Z (28 days ago)
- Topics: ai, ai-agents, api, claude-code, mcp, mcp-api, mcp-client, mcp-clients, mcp-gateway, mcp-server, mcp-tools, timely, timelyapp
- Language: TypeScript
- Homepage:
- Size: 29.3 KB
- Stars: 0
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
Timely MCP server
  
MCP 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.
## Features
- Read and create time entries with labels/tags
- Browse projects, users, and tasks
- Auto-refreshes expired OAuth tokens
- Auto-detects account ID during setup
## Tools
| Tool | Description |
|------|-------------|
| `timely_me` | Current user info |
| `timely_list_projects` / `timely_get_project` | Projects |
| `timely_list_users` / `timely_get_user` | People |
| `timely_list_events` / `timely_get_event` | Time entries (filterable by date, user, project) |
| `timely_create_event` / `timely_update_event` / `timely_delete_event` | Manage time entries |
| `timely_list_labels` / `timely_get_label` | Labels/tags |
| `timely_list_tasks` / `timely_get_task` | Tasks/forecasts |
## Setup
### 1. Create a Timely OAuth app
Go to `https://app.timelyapp.com//oauth_applications` and create a new app with redirect URI `https://localhost:7890/callback`.
### 2. Configure
```bash
cp .env.example .env
```
Add `TIMELY_CLIENT_ID` and `TIMELY_CLIENT_SECRET` from the OAuth app.
### 3. Authenticate
```bash
bun install
bun auth.ts
```
Open the URL in your browser and authorize. Tokens and account ID are saved automatically.
### 4. Add to Claude Code
```bash
claude mcp add timely --transport stdio --scope user \
-- bun /path/to/timely-mcp-server/server.ts
```
### 5. Verify
In Claude Code, run `/mcp` and check that `timely` shows as connected.
## Token refresh
The server auto-refreshes expired access tokens. No manual re-auth needed unless the refresh token is revoked.
## Requirements
- [Bun](https://bun.sh) runtime
- Timely account with API access