Tripletex MCP Server

An MCP (Model Context Protocol) server for the Tripletex accounting API. Enables AI assistants to log hours, manage timesheets, and handle invoices through natural language.

Features

• Time tracking — log hours, start/stop timers, search entries

• Projects & activities — look up projects and activities by name

• Timesheet approval — complete, approve, and reopen weekly/monthly timesheets

• Invoices — search outgoing and incoming invoices

• Supplier invoice approval — approve or reject supplier invoices

Setup

1. Get your Tripletex API tokens

You need two tokens from Tripletex:

• Consumer token — provided after API 2.0 registration

• Employee token — created by an admin in Tripletex under user settings > "API access"

The server automatically creates a session token on first use (valid 1 day).

2. Configure your MCP client

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tripletex": {
      "command": "npx",
      "args": ["-y", "tripletex-mcp"],
      "env": {
        "TRIPLETEX_CONSUMER_TOKEN": "<your-consumer-token>",
        "TRIPLETEX_EMPLOYEE_TOKEN": "<your-employee-token>"
      }
    }
  }
}

Or to install from GitHub directly:

{
  "mcpServers": {
    "tripletex": {
      "command": "npx",
      "args": ["-y", "github:adriantr/tripletex-mcp"],
      "env": {
        "TRIPLETEX_CONSUMER_TOKEN": "<your-consumer-token>",
        "TRIPLETEX_EMPLOYEE_TOKEN": "<your-employee-token>"
      }
    }
  }
}

Environment variables

Tools

Authentication

• whoami — Get information about the currently authenticated user

Projects & Activities

• search_projects — Search for projects by name or other filters

• search_activities — Search for activities (e.g. development, meetings, vacation)

Time Tracking

• search_timesheet_entries — Search timesheet entries for a date range

• get_timesheet_entry — Get a single timesheet entry by ID

• create_timesheet_entry — Log hours for a project/activity/date

• update_timesheet_entry — Update an existing timesheet entry

• delete_timesheet_entry — Delete a timesheet entry

• get_total_hours — Get total hours for a date range

• get_recent_projects — Get recently used projects

• get_recent_activities — Get recently used activities for a project

Time Clock

• start_time_clock — Start a real-time timer

• stop_time_clock — Stop a running timer

• get_current_time_clock — Get the currently running timer

Timesheet Approval

• search_timesheet_weeks — Search weekly timesheet status

• approve_timesheet_week — Approve a timesheet week

• complete_timesheet_week — Mark a week as complete

• reopen_timesheet_week — Reopen a completed/approved week

• get_timesheet_month — Get monthly timesheet status

• approve_timesheet_month — Approve a timesheet month

• complete_timesheet_month — Mark a month as complete

• reopen_timesheet_month — Reopen a completed/approved month

Invoices

• search_invoices — Search outgoing (customer) invoices

• get_invoice — Get a single outgoing invoice by ID

• search_supplier_invoices — Search incoming (supplier) invoices

• get_supplier_invoice — Get a single supplier invoice by ID

• get_supplier_invoices_for_approval — Get invoices pending approval

• approve_supplier_invoice — Approve a supplier invoice

• approve_supplier_invoices — Approve multiple supplier invoices

• reject_supplier_invoice — Reject a supplier invoice (comment required)

• reject_supplier_invoices — Reject multiple supplier invoices (comment required)

Development

npm install
npm run build

License

ISC