home / mcp / tripletex mcp server

Tripletex MCP Server

Provides an MCP server for Tripletex to log hours, manage timesheets, and handle invoices through natural language.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "adriantr-tripletex-mcp": {
      "command": "node",
      "args": [
        "/path/to/tripletex-mcp/dist/index.js"
      ],
      "env": {
        "TRIPLETEX_API_URL": "https://tripletex.no/v2",
        "TRIPLETEX_COMPANY_ID": "0",
        "TRIPLETEX_CONSUMER_TOKEN": "<your-consumer-token>",
        "TRIPLETEX_EMPLOYEE_TOKEN": "<your-employee-token>"
      }
    }
  }
}

You can run a Tripletex MCP Server to connect your Tripletex accounting data with AI assistants. It enables natural-language interactions for logging hours, managing timesheets, and handling invoices through a secure MCP interface.

How to use

Start by running the MCP server locally, then configure your MCP client to connect to it. Use the provided tokens to authorize requests to Tripletex. Once connected, you can log hours, search and manage timesheets, and work with invoices through natural language commands. The server handles session management and token usage so you can focus on your workflows.

How to install

Prerequisites: you need Node.js and npm installed on your system.

Step 1: Clone the repository and install dependencies.

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

Configuration and startup

Configure your MCP client with the required Tripletex API tokens. The server authenticates using a consumer token and an employee token, and it creates a session token on first use (valid for 1 day). Use the tokens in your client configuration as shown.

{
  "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 and tokens

Set these environment variables in your MCP client configuration to authorize against Tripletex and to customize behavior.

Run-time notes

The server starts when you run the configured command. It will expose the MCP endpoints locally so your client can issue operations like logging hours, searching projects, and handling invoices.

Additional notes

Keep tokens secure and rotate them as needed. For production deployments, consider securing the local MCP listener and restricting access to trusted clients.

Available tools

Authentication

Obtain and use consumer and employee tokens to authorize actions against Tripletex APIs.

Projects & Activities

Search for projects and activities by name or filters to attach work items.

Time Tracking

Log hours, create and modify timesheet entries, and query total hours.

Time Clock

Start, stop, and monitor a real-time timer for current work sessions.

Timesheet Approval

Search, approve, complete, or reopen weekly and monthly timesheets.

Invoices

Search and retrieve outgoing and incoming invoices; approve supplier invoices.