create_contact
Create a new contact
LABSCO SUMMARY
Broad write access to a timesheet system, approval steps included.
This is not a reporting wrapper: most groups support create, update and delete, and expenses and mileage carry their own status transitions and status history. The API key you hand it is the boundary — an agent with it can approve an expense or delete a project as easily as it can list one.
What it is
A single-file JavaScript server covering TimeChimp API v2. It exposes 46 tools across ten resource groups, and passes OData conventions through, so $filter, $orderby, $expand, $count and pagination all work the way they do in the underlying API.
What you get
- Projects created, read, updated and deleted, plus per-project insights —
get_projects,get_project_by_id,create_project,update_project,delete_project,get_project_insights - Users with their roles, contracts and tags —
get_users,get_user_by_id,create_user,update_user - Time entries fetched over a date range, filtered by user or project —
get_time_entries,get_time_entry_by_id - Contacts and customers over their full lifecycle —
get_contacts,create_contact,update_contact,delete_contact,get_customers,create_customer,update_customer,delete_customer - Expenses with an approval workflow: create, edit, delete, move status, move client status, and read the status history —
create_expense,update_expense,update_expense_status,update_expense_client_status,get_expense_status_history - Mileage with the same status handling plus vehicle assignment —
create_mileage,update_mileage_status,get_mileage_status_history,get_mileage_vehicles - Tasks, invoices and tags for filtering and reporting —
get_tasks,get_invoices,get_tags
Requirements
A TimeChimp account with API access and its key in TIMECHIMP_API_KEY, from your profile settings' API section. Node.js 18.0.0 or higher. Runs as a Node process against timechimp-mcp-server.js with the repository as the working directory.
Setup effort
One command plus a key — npx -y github:ArmandSwirc/TimeChimpMCP, then supply credentials
USE CASES
01
Working through the expenses waiting for approval
List expenses, read an individual one and its status history, then move it forward — the client-facing status is a separate call from the internal one.
02
Setting up a new client engagement
Create the customer, add the contact people, then create the project with its invoicing and budgeting settings and its task and user assignments.
03
Answering where the hours went last month
Pull time entries over the date range filtered by project or user, and read project insights for the budget picture rather than adding it up by hand.
04
Logging a trip after the fact
Create the mileage record against the right vehicle, then push it through its status once it is ready to bill.
46 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
create_customer
Create a new customer
create_expense
Create a new expense
create_mileage
Create a new mileage entry
create_project
Create a new project
create_user
Create a new user (note: adding users can result in additional invoice and extra cost)
delete_contact
Delete a contact
delete_customer
Delete a customer
delete_expense
Delete an expense
delete_mileage
Delete a mileage entry
delete_project
Delete a project
get_contact_by_id
Get a specific contact by ID
get_contacts
Retrieve all contacts from TimeChimp
get_customer_by_id
Get a specific customer by ID
get_customers
Retrieve all customers from TimeChimp
get_expense_by_id
Get a specific expense by ID
get_expense_status_history
Query status history modification records of an expense
get_expenses
Retrieve all expenses from TimeChimp
get_invoice_by_id
Get a specific invoice by ID
get_invoices
Retrieve all invoices from TimeChimp
get_mileage
Retrieve all mileage entries from TimeChimp
get_mileage_by_id
Get a specific mileage entry by ID
get_mileage_status_history
Query status history modification records of a mileage entry
get_mileage_vehicle_by_id
Get a specific mileage vehicle by ID
get_mileage_vehicles
Retrieve all mileage vehicles from TimeChimp
get_project_by_id
Get a specific project by ID
get_project_insights
Get project insights including hours, budget, costs, and revenue data
get_projects
Retrieve all projects from TimeChimp
get_tag_by_id
Get a specific tag by ID
get_tags
Retrieve all tags from TimeChimp
get_task_by_id
Get a specific task by ID
get_tasks
Retrieve all tasks from TimeChimp
get_time_entries
Retrieve time entries from TimeChimp
get_time_entry_by_id
Get a specific time entry by ID
get_user_by_id
Get a specific user by ID
get_users
Retrieve all users from TimeChimp
update_contact
Update an existing contact
update_customer
Update an existing customer
update_expense
Update an existing expense
update_expense_client_status
Update the client status of expenses (external approval/invoicing status)
update_expense_status
Update the status of expenses (internal approval/invoicing status)
update_mileage
Update an existing mileage entry
update_mileage_client_status
Update the client status of mileage entries (external approval/invoicing status)
update_mileage_status
Update the status of mileage entries (internal approval/invoicing status)
update_project
Update an existing project
update_user
Update an existing user
BEFORE YOU INSTALL
What to know first
Tools you get
46 tools when we connected.
Requires
- npx on PATH
- Node.js 18.0.0 or later
- TIMECHIMP_API_KEY in your environment
CONTEXT COST
Heavy Standing cost
Rated by the size of the 46 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y github:ArmandSwirc/TimeChimpMCPMCP Clients
Claude Desktop
CLAUDE DESKTOP · TERMINAL
git clone https://github.com/ArmandSwirc/TimeChimpMCP.git
cd TimeChimpMCP
npm installCLAUDE DESKTOP · JSON
{
"mcpServers": {
"timechimp": {
"command": "node",
"args": [
"timechimp-mcp-server.js"
],
"cwd": "<YOUR_PATH_TO_TIME_CHIMP_MCP>",
"env": {
"TIMECHIMP_API_KEY": "<YOUR_TIMECHIMP_API_KEY>"
}
}
}
}<YOUR_PATH_TO_TIME_CHIMP_MCP> is the full path of your clone (the folder holding timechimp-mcp-server.js).
Any MCP client
ANY MCP CLIENT · JSON
{
"mcpServers": {
"TimeChimpMCP": {
"command": "npx",
"args": [
"-y",
"github:ArmandSwirc/TimeChimpMCP"
],
"env": {
"TIMECHIMP_API_KEY": "<YOUR_TIMECHIMP_API_KEY>"
}
}
}
}Runs the repository straight from GitHub through npx — no clone needed. <YOUR_TIMECHIMP_API_KEY> is your TimeChimp API key (profile settings → API section).
