TimePRO MCP Server
This server enables AI assistants to manage timesheets in the TimePRO system, allowing them to create, read, update, delete, and search timesheets and related data on behalf of authenticated users.
List Clients – Search and retrieve clients by name.
List Projects – Get available projects for a specific client.
List Categories – Retrieve timesheet work categories (e.g., Development, Meeting, Admin).
List Locations – Get available work locations (e.g., Office, Remote, Client Site).
Get Timesheet Defaults – Fetch default values (e.g., last used client/project) for a given date before creating a timesheet.
List Timesheets – View a summary of timesheets within a specified date range.
Get Timesheet – Retrieve full details of a specific timesheet by ID.
Create Timesheet – Add a new timesheet entry with client, project, category, date, start/end times, and optional details like notes, location, break time, and billable category.
Update Timesheet – Modify any fields of an existing timesheet.
Delete Timesheet – Remove a timesheet entry by its ID.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@TimePRO MCP Server Log 8 hours of development work for SSW today from 9am to 5pm"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
TimePro MCP Server
An MCP (Model Context Protocol) server that wraps the TimePro API, enabling AI assistants to automatically create and manage timesheets on behalf of authenticated users.

Watch the video above for more information.
Features
List clients - Search for clients to use in timesheets
List projects - Get projects for a specific client
List categories - Get available timesheet categories (Development, Meeting, etc.)
List locations - Get available work locations
Get timesheet defaults - Get default values including last used client/project
List timesheets - View timesheets for a date range
Get timesheet - Get full details of a specific timesheet
Create timesheet - Create a new timesheet entry
Update timesheet - Modify an existing timesheet
Delete timesheet - Remove a timesheet
Related MCP server: EARLY App MCP Server
Quick Start (npx - No Installation Required)
Add to your Claude Desktop config (claude_desktop_config.json):
{
"mcpServers": {
"timepro": {
"command": "npx",
"args": ["-y", "github:calumjs/TimePRO.MCP"],
"env": {
"TIMEPRO_API_URL": "https://ssw.sswtimepro.com",
"TIMEPRO_API_KEY": "your-api-key-here",
"TIMEPRO_TENANT_ID": "ssw"
}
}
}
}The config file location:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Configuration
The server requires three environment variables:
Variable | Description | Example |
| TimePRO base URL |
|
| Your personal access token |
|
| Your tenant ID |
|
How to Get Your API Key
Log into TimePRO: Go to your TimePro instance and sign in
Navigate to API Key page: Go to Admin > API Key
Generate or Copy Key: If you already have a key, it will be displayed. Click "Generate" to create a new key if needed.
Copy the key: Store it securely
How to Find Your Tenant ID
The tenant ID is visible in:
The URL when logged into TimePro (e.g.,
https://ssw.sswtimepro.com/b/ssw/...- tenant is "ssw")The
x-timepro-tenant-idheader in browser dev tools (Network tab)Ask your TimePRO administrator
Alternative: Local Installation
If you prefer to install locally:
git clone https://github.com/calumjs/TimePRO.MCP.git
cd TimePRO.MCP
npm install
npm run buildThen use this config:
{
"mcpServers": {
"timepro": {
"command": "node",
"args": ["/path/to/TimePRO.MCP/dist/index.js"],
"env": {
"TIMEPRO_API_URL": "https://ssw.sswtimepro.com",
"TIMEPRO_API_KEY": "your-api-key-here",
"TIMEPRO_TENANT_ID": "ssw"
}
}
}
}Usage Examples
Once configured, you can ask Claude to manage your timesheets naturally:
"What clients do I have access to?"
"Show me my timesheets for this week"
"Create a timesheet for SSW internal work today from 9am to 5pm"
"Log 2 hours of development work on the SugarLearning project"
"Delete my timesheet from yesterday"
Tools Reference
list_clients
Search for clients by name.
Parameters:
search_text(optional): Filter clients by name
list_projects
Get projects for a client.
Parameters:
client_id(required): Client ID (string, e.g., "SSW")
list_categories
Get available timesheet categories. No parameters.
list_locations
Get available work locations. No parameters.
get_timesheet_defaults
Get default values for creating a timesheet.
Parameters:
date(required): Date in YYYY-MM-DD format
list_timesheets
List timesheets in a date range.
Parameters:
start_date(required): Start date in YYYY-MM-DD formatend_date(required): End date in YYYY-MM-DD format
get_timesheet
Get details of a specific timesheet.
Parameters:
timesheet_id(required): Timesheet ID (number)
create_timesheet
Create a new timesheet entry.
Parameters:
client_id(required): Client ID (string)project_id(required): Project ID (string)category_id(required): Category ID (string)date(required): Date in YYYY-MM-DD formatstart_time(required): Start time in HH:MM formatend_time(required): End time in HH:MM formatbreak_minutes(optional): Break time in minutes (default: 0)location_id(optional): Work location IDbillable_id(optional): Billable category IDnote(optional): Description of work
update_timesheet
Update an existing timesheet.
Parameters:
timesheet_id(required): Timesheet ID (number)All other parameters from create_timesheet (optional)
delete_timesheet
Delete a timesheet.
Parameters:
timesheet_id(required): Timesheet ID (number)
Troubleshooting
"Missing required environment variables"
Ensure all three environment variables are set in your Claude Desktop config.
"TimePRO API error (401)"
Your API key may be invalid or expired. Generate a new one from TimePRO Admin > API Key.
"TimePro API error (403)"
Your user account may not have permission for the requested operation.
Connection issues
Verify the TIMEPRO_API_URL is correct and accessible from your network.
License
MIT
Available Tools
10 toolscreate_timesheetA
Create a new timesheet entry. Requires client, project, category, date, and time range. Returns the created timesheet ID.
Inputs: client_id (required), project_id (required), category_id (required), date (required), +6 more.
delete_timesheetC
Delete a timesheet by its ID.
Inputs: timesheet_id (required).
get_timesheetC
Get full details of a specific timesheet by its ID.
Inputs: timesheet_id (required).
get_timesheet_defaultsA
Get default values for creating a timesheet, including last used client, project, and rates. Call this before creating a timesheet to get sensible defaults.
Inputs: date (required).
list_categoriesB
Get available timesheet categories (e.g., Development, Meeting, Admin). These categorize the type of work done.
Inputs: no named parameters.
list_clientsC
Search for clients to use in timesheets. Returns a list of clients with their IDs and names.
Inputs: search_text.
list_locationsB
Get available work locations (e.g., Office, Client Site, Remote).
Inputs: no named parameters.
list_projectsB
Get projects for a specific client. Use this after selecting a client to find available projects.
Inputs: client_id (required).
list_timesheetsA
List timesheets for the current user within a date range. Returns summary information for each timesheet.
Inputs: start_date (required), end_date (required).
update_timesheetB
Update an existing timesheet. All fields except timesheet_id are optional - only provided fields will be updated.
Inputs: timesheet_id (required), client_id, project_id, category_id, +7 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a clearly distinct purpose with no ambiguity. Tools are organized around specific resources (timesheets, clients, projects, categories, locations) and actions (create, delete, get, list, update), making it easy for an agent to select the correct one without confusion.
All tool names follow a consistent verb_noun pattern using snake_case, such as create_timesheet, list_clients, and update_timesheet. This predictability enhances readability and usability for agents navigating the tool set.
With 10 tools, the server is well-scoped for timesheet management, covering essential operations like CRUD for timesheets and listing related resources. Each tool serves a clear purpose without redundancy, making the count appropriate for the domain.
The tool set provides complete coverage for timesheet management, including full CRUD operations (create, get, update, delete, list), support for related entities (clients, projects, categories, locations), and a utility tool for defaults. There are no obvious gaps that would hinder agent workflows.
Maintenance
Related MCP Connectors
MCP server exposing klokin time-tracking operations (employees, time entries, stores) to AI clients.
timesheet.io MCP server - manage timers, projects, tasks and reports
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
Manage Timequip projects, tasks, comments, members, and dashboards through MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA comprehensive MCP server for time tracking, project management, and AI-powered memory storage using semantic search. It enables users to log time, manage client billing, and capture shared or personal ideas through integrated tools and team collaboration features.1MIT
- AlicenseBqualityBmaintenanceAn MCP server that provides AI assistants with access to the EARLY time tracking public API, enabling time entry management, activity management, and report generation through natural language.1462 npmMIT
- AlicenseAqualityDmaintenanceThis MCP server allows AI assistants to interact with the Beebole REST API for time tracking management.4MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server for controlling the TimeLiner project management system, enabling AI clients to manage projects, tasks, members, and more via natural language.-