Skip to main content
Glama
rollecode

timely-mcp-server

by rollecode
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Timely MCP server

Version TypeScript Bun

MCP server for Timely 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

Related MCP server: Tempo MCP Server

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/<your-account-id>/oauth_applications and create a new app with redirect URI https://localhost:7890/callback.

2. Configure

cp .env.example .env

Add TIMELY_CLIENT_ID and TIMELY_CLIENT_SECRET from the OAuth app.

3. Authenticate

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

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 runtime

  • Timely account with API access

This server cannot be installed

F
license - not found
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
0dRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/rollecode/timely-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server