Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.mytruv.com/llms.txt

Use this file to discover all available pages before exploring further.

​
What is MyTruv CLI?

MyTruv CLI is a command-line tool for accessing your MyTruv financial data from the terminal. Check balances, pull transactions, review income, and analyze spending without leaving the shell. It authenticates via browser-based OAuth - no API keys or tokens to manage. The project is open source at github.com/truvhq/mytruv-cli.
The CLI is read-only. It cannot modify your accounts, create transactions, or change any settings - the same guarantee as MyTruv MCP.

​
Prerequisites

  • Python 3.10+
  • A MyTruv account with at least one connected financial account

​
Install

After installation, the mytruv command is on your $PATH. To uninstall: 
rm "$(command -v mytruv)"

​
Quick Start

# 1. Log in (opens browser)
mytruv auth login

# 2. View your connected accounts
mytruv links

# 3. Check balances
mytruv balances

# 4. Pull recent transactions
mytruv transactions

# 5. Log out
mytruv auth logout

​
Commands

​
Authentication

CommandDescription
mytruv auth loginAuthenticate via browser-based OAuth
mytruv auth login --no-browserPrint login URL (for headless/remote machines)
mytruv auth logoutLog out and revoke tokens
mytruv auth statusShow current authentication status ({authenticated, user})

​
Financial Data

CommandDescription
mytruv userYour user profile, including lifecycle flags (subscription, onboarding, trial)
mytruv linksPaginated list of connected providers ({count, next, previous, results})
mytruv balancesAggregated balances by account type ({total_accounts, accounts, aggregated_balances})
mytruv liabilitiesAggregated liabilities for credit cards and loans ({accounts, liabilities})
mytruv transactionsBank transactions, last 7 days by default (--from, --to, --categories, --page, --page-size)
mytruv spendingSpending breakdown by category/merchant/time-period (--group-by, --time-period, --days, --start-date, --end-date)
mytruv incomeIncome from payroll and bank sources, each tagged with data_source (--days, default 90)
mytruv recurringRecurring transactions (subscriptions, deposits)
mytruv balance-historyBalance trends over time (--date-range 1m|3m|6m|1y|all, --time-period day|week|month)

​
Output formats

Every data command accepts:
FlagBehavior
-o, --output [json|csv]Force a format. Default: table on TTY, JSON when piped.
--jsonShorthand for --output json.
--no-colorDisable ANSI colors (useful in CI).
CSV output formats currency as strings (e.g. "$1,234.56"). For raw numbers, use JSON.

​
MCP Server

CommandDescription
mytruv mcpStart an MCP stdio server for local AI agent integration
See Agent & Automation for the Gemini CLI extension setup.

​
Shell Completion

CommandDescription
mytruv completion bashPrint bash completion script
mytruv completion zshPrint zsh completion script
mytruv completion fishPrint fish completion script
Add to your shell config: 
# bash (~/.bashrc)
source <(mytruv completion bash)

# zsh (~/.zshrc)
source <(mytruv completion zsh)

# fish (~/.config/fish/config.fish)
mytruv completion fish | source

​
Next steps

Agent & Automation

JSON output, exit codes, MCP stdio mode, Gemini extension

MyTruv MCP

Hosted MCP server for remote AI assistants

GitHub Repo

Source, issues, and release notes

API Reference

REST API for programmatic access