Timely MCP

Getting Started

Install and configure the Timely MCP server to let Claude interact with your Timely account directly.

Prerequisites

• A Timely account
• A personal access token (Account Settings → API)
• Your workspace ID (visible in your Timely URL)

Claude Desktop Configuration

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "timely": {
      "command": "npx",
      "args": ["-y", "@kva/timely-mcp"],
      "env": {
        "TIMELY_API_KEY": "your-api-key",
        "TIMELY_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

Tools Available

list_projects

List all active projects in your Timely workspace.

Example: "What projects are active in my workspace right now?"

log_time

Create a time entry on a project.

Parameters:

• project_id — the project to log against
• duration — duration in minutes
• note — optional description
• date — ISO date string (defaults to today)

Example: "Log 2 hours on Project Alpha for today under the Design category."

get_events

Query logged time events by date range.

Parameters:

• since — start date (ISO)
• until — end date (ISO, defaults to today)

Example: "Show me all events I tracked this week and how many hours per project."

Security

Your API key is passed as an environment variable and never leaves your machine. The MCP server communicates directly with the Timely API over HTTPS.