Tripletex / Tripletex/tripletex-mcp

Feature Request: Project result reports — hours, costs, and revenue per project per period (resultatrapport)

Open
#2 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
No language data
Stars
9
Forks
0
PR merge metrics
No merged PRs in 30d

Description

Current state

The Tripletex MCP server provides good granular access to projects
(search_projects), hour entries (search_timesheet_entries), supplier invoices,
and overall timesheet management. However, there is currently no convenient way
to retrieve a consolidated project result report (resultatrapport) for a given
project over a period.

Today an assistant can:

  • List projects and hour entries
  • Search invoices and supplier invoices

…but must manually combine these sources to calculate revenue vs. costs, gross
margin, and total hours for a project in a specific period. There is no single
call that returns the aggregated financial performance of a project.

Requested tools

  • get_project_result_report(projectId, dateFrom, dateTo) — Consolidated report
    for one project in the period containing:

    • Total revenue / invoiced amount
    • Total costs booked (from ledger / supplier invoices)
    • Registered hours (from timesheet entries)
    • Gross margin / result
    • Optional breakdown by activity, employee, or cost type
  • search_project_result_reports(dateFrom, dateTo, projectIds?, customerId?)
    Result reports for multiple projects in the period (for monthly/periodic
    reporting across a portfolio)

  • get_project_hours_summary(projectId, dateFrom, dateTo) — Aggregated hours
    per employee/activity for the period (more convenient than manually paging
    through search_timesheet_entries)

  • get_project_cost_summary(projectId, dateFrom, dateTo) — Aggregated costs
    by account/supplier for the period

Why this matters

In Norwegian construction and project-based companies, the resultatrapport is
one of the most frequently used reports for project managers and controllers.
Being able to fetch it programmatically would let AI assistants:

  • Generate monthly project status reports automatically
  • Compare actual vs. budget (prognose) without the user opening Tripletex
  • Surface overruns early (e.g. "Project 4333 is 12 % over budget on costs this
    month")
  • Support the existing budget/prognose routines that many teams already run
    twice a year

The underlying Tripletex REST API already contains the necessary data. This
request is about surfacing the aggregated view through the MCP in the same
clean, consistent style as the existing read tools.

Additional notes

  • Access control should follow the same rules as the existing hour and invoice
    tools (department/project restrictions).
  • Date range should follow the inclusive start / exclusive end convention used
    by the existing tools.
  • Returning both a human-readable summary and a structured JSON object would be
    useful for assistants.

Thank you for the great work on this MCP server — it's already very useful, and
closing this gap would make it even more powerful for project-based companies.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the existing search_projects, search_timesheet_entries, invoice, and supplier-invoice tools and the Tripletex REST API report endpoints they use. Define the scope and response shape for the requested project result, hours, and cost summaries, then verify date boundaries and access-control behavior; done means the selected report tools return the requested aggregated fields for the specified period.

Written by the indexing model from the issue text.

Assessment

Domain
api, backend
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.