[All projects](https://mysticcoders.com/projects)

AI Tools

# Freshbooks Tools

Freshbooks integration that doubles as a Claude skill. Automate your invoicing and time tracking.

Claude CodeFreshbooksAutomationPython

[Source Code](https://github.com/mysticcoders/freshbooks-tools)

## What It Is

A Python CLI for querying FreshBooks financial data that also works as a Claude Code skill. Get AR aging reports, revenue summaries, time entries, and invoice details from your terminal or through natural language via Claude.

## Features

-   **AR aging reports** with client receivables tracking
-   **Revenue summaries** with DSO (Days Sales Outstanding) metrics
-   **Time entry management** for tracking billable hours
-   **Invoice listing** and financial overview
-   **Team member rates** and utilization data
-   **JSON output** mode for structured data (`--json` flag on all commands)

## Tech Stack

-   **Python 3.11+** with uv for dependency management
-   **FreshBooks OAuth 2.0** authentication (uses ngrok for local HTTPS callbacks)
-   **Platform-specific token storage** for secure credential management

## Usage

Works standalone as a CLI tool or integrated directly with Claude Code for natural language queries like “show me outstanding invoices” or “what’s our AR aging look like?”