Tripletex MCP Server

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. Install

git clone https://github.com/your-org/tripletex-mcp.git
cd tripletex-mcp
npm install
npm run build

3. Configure your MCP client

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

{
  "mcpServers": {
    "tripletex": {
      "command": "node",
      "args": ["/path/to/tripletex-mcp/dist/index.js"],
      "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