MyTruv CLI

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.

Already signed in to MyTruv? Find this and the other AI integration links anytime from Settings > AI Integrations in the web app.

Prerequisites

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

Install

curl (recommended)
uv

curl -fsSL https://raw.githubusercontent.com/truvhq/mytruv-cli/master/scripts/install.sh | sh

Installs to ~/.local/bin by default. To install somewhere else, pass INSTALL_DIR to the piped shell:

curl -fsSL https://raw.githubusercontent.com/truvhq/mytruv-cli/master/scripts/install.sh | INSTALL_DIR=/usr/local/bin sh

Linux binaries need glibc 2.35+ (Ubuntu 22.04, Debian 12, RHEL 9).

uv tool install git+https://github.com/truvhq/mytruv-cli.git

Requires uv.

After installation, the mytruv command is on your $PATH. Startup is under 0.2 seconds on a warm cache. 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

Command	Description
`mytruv auth login`	Authenticate via browser-based OAuth
`mytruv auth login --no-browser`	Print login URL (for headless/remote machines)
`mytruv auth logout`	Log out and revoke tokens
`mytruv auth status`	Show current authentication status (`{authenticated, user}`)

Financial Data

Command	Description
`mytruv user`	Your user profile, including `lifecycle` flags (subscription, onboarding, trial)
`mytruv links`	Connected bank and payroll providers
`mytruv links report <link_id>`	Income report for a specific link (payroll or bank income)
`mytruv balances`	Aggregated balances by account type (`{total_accounts, accounts, aggregated_balances}`)
`mytruv liabilities`	Aggregated liabilities for credit cards and loans (`{accounts, liabilities}`)
`mytruv transactions`	Bank transactions, last 7 days by default (`--from`, `--to`, `--type`, `--account`, `--category`, `--min-amount`, `--max-amount`, `--merchant`, `--sort`, `--order`, `--page`, `--page-size`)
`mytruv spending`	Spending breakdown by category/merchant/time-period (`--group-by`, `--time-period`, `--days`, `--start-date`, `--end-date`)
`mytruv income`	Income from payroll and bank sources, each tagged with `data_source` (`--days`, default 90)
`mytruv recurring`	Recurring transactions (subscriptions, deposits)
`mytruv balance-history`	Balance trends over time (`--date-range` `1M\|3M\|6M\|1Y\|ALL`, `--time-period` `day\|week\|month`)
`mytruv insights`	AI-generated financial insights, rendered as title, summary, detail, and follow-up suggestions

Output formats

Every data command accepts:

Flag	Behavior
`-o, --output [json\|csv]`	Force a format. Default: table on TTY, JSON when piped.
`--json`	Shorthand for `--output json`.
`--no-color`	Disable ANSI colors (useful in CI).

CSV output formats currency as strings (e.g. "$1,234.56"). For raw numbers, use JSON. --output csv on transactions streams directly from the server and supports up to 10,000 rows per export.

MCP Server

Command	Description
`mytruv mcp`	Start an MCP stdio server for local AI agent integration

See Agent & Automation for the Gemini CLI extension setup.

Shell Completion

Command	Description
`mytruv completion bash`	Print bash completion script
`mytruv completion zsh`	Print zsh completion script
`mytruv completion fish`	Print 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

Global flags

Flag	Behavior
`--version`	Print the installed CLI version and exit
`--help`	Show help for `mytruv` or any subcommand

Environment variables

Variable	Description
`MYTRUV_CONFIG_DIR`	Directory for config and stored credentials. Default: `~/.config/mytruv`.
`NO_COLOR`	Set to any value to disable ANSI colors (same as `--no-color`).
`NUITKA_ONEFILE_TEMPDIR`	Override where the self-contained binary unpacks on first run (useful when `$HOME` is read-only).
`MYTRUV_VERSION`	Pin the version the install script downloads (install-time only).

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

Introduction

MCP for AI Chats

MCP for AI Agents

CLI for AI Agents

Developer MCP

What is MyTruv CLI?

Prerequisites

Install

Quick Start

Commands

Authentication

Financial Data

Output formats

MCP Server

Shell Completion

Global flags

Environment variables

Next steps

Agent & Automation

MyTruv MCP

GitHub Repo

API Reference

​What is MyTruv CLI?

​Prerequisites

​Install

​Quick Start

​Commands

​Authentication

​Financial Data

​Output formats

​MCP Server

​Shell Completion

​Global flags

​Environment variables

​Next steps

Agent & Automation

MyTruv MCP

GitHub Repo

API Reference

What is MyTruv CLI?

Prerequisites

Install

Quick Start

Commands

Authentication

Financial Data

Output formats

MCP Server

Shell Completion

Global flags

Environment variables

Next steps