Pp Terminal

The Analytic Companion for Portfolio Performance

LLM Mart 0 views 18 listing impressions

A powerful command-line interface (CLI) that allows programmatic access to Portfolio Performance data to offer a whole new level of insights into your assets.

pp-terminal is a lightweight tool for all the nice-to-have features that won't make it into the official Portfolio Performance app. This can be because of country-specific tax rules, complex Java implementation, highly individual requirements, too many edge-cases, etc.

Use Cases

You can run the single commands individually or pp-terminal can act as an MCP server to give AI models like Claude Opus, Gemini or Qwen access to your (anonymized) portfolio to help you answer questions like:

  • "Give me an overview of my portfolio"
  • "What do you think about my portfolio allocation? Am I overweight anywhere?"
  • "Do I have enough cash to cover the upcoming Vorabpauschale taxes?"
  • "I need 1k EUR after tax. Which securities should I sell to minimize taxes?"

Thís application supports specific tax concepts like FIFO, Sparer-Pauschbetrag, Grundfreibetrag, Günstigerprüfung and Teilfreistellungen.

Important

I am not a tax consultant. All results of this application are just a non-binding indication and without guarantee. They may deviate from the actual values.

For example, pp-terminal includes a CLI command to calculate the Vorabpauschale (preliminary taxes) for Germany: Vorabpauschale command in pp-terminal

Tip

Using MoneyMoney for managing your finances? Check out how to export Sankey Charts.

  1. Available Commands
  2. Requirements
  3. Installing
  4. Usage
  5. Contributing
  6. Known Limitations
  7. License

Available Commands

Code completion for commands and options is available.
You can choose between different output formats like JSON, CSV or Excel with the --output option.

In addition to the standard set, you can easily create your own commands and share them with the community.

By default, pp-terminal --help provides the following commands:

MCP Server

The application can be used to access Portfolio Performance data using an MCP server.
This has several advantages over directly working on the XML file, e.g.

  • Safely access sensitive financial data by e.g. anonymization and only exposing relevant portfolio information
  • Significantly reduce context length and token usage

The MCP server can be started with the following command:

pp-terminal mcp

Inspect Portfolio

Command Description
view accounts Get detailed information about the balances per each deposit and/or securities account
view cash-flows Get the cumulative deposits, withdrawals and net contributions per currency
view securities Get detailed information about the securities
view taxonomies Get detailed information about the taxonomies

From the project's README.