# Freeagent

> FreeAgent integration for AI agents via ClawLink — browser login, no API key setup. Connect FreeAgent through ClawLink's hosted setup to manage invoices, estimates, bills, contacts, banking, and accounting reports. Use this skill when the user wants to work with FreeAgent (Payments & Finance) — connect FreeAgent, read or update FreeAgent data, or take actions in FreeAgent from chat instead of saying you cannot access it.

- Skill: `clawlink-hq/freeagent` (Agent Skill)
- Install (CLI): `npx skillmds@latest add clawlink-hq/freeagent`
- Raw SKILL.md: https://api.skillmd.com/api/skills/clawlink-hq/freeagent/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Finance & Business
- Author: clawlink-hq (https://skillmd.com/u/clawlink-hq)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/clawlink-hq/freeagent

---


# FreeAgent

Use **FreeAgent** from your AI agent through [ClawLink](https://claw-link.dev) — browser login, no API key to paste, no config to edit. Connect FreeAgent once and the agent can read and act on it. Works in any agent that can run shell commands (Claude Code, Cursor, Codex, Cline, and more).

## Setup

Run these once — the agent can run them for you:

```bash
npx @useclawlink/cli login              # opens browser → approve (mints + stores a key)
npx @useclawlink/cli connect freeagent   # opens browser → authorize FreeAgent
```

No API key to create or paste — `login` stores the credential at `~/.clawlink/credentials.json`.

## Using FreeAgent

```bash
npx @useclawlink/cli actions freeagent "<what you want to do>"   # find an action
npx @useclawlink/cli describe freeagent <action-id>             # see its inputs (before writes)
npx @useclawlink/cli run freeagent <action-id> --input '<json>' # execute
```

Reads first; confirm with the user before any write.

## Available actions

| Action | Description |
|--------|-------------|
| `freeagent_company_details` | Get company details from FreeAgent |
| `freeagent_create_invoice` | Create an invoice in FreeAgent |
| `freeagent_create_estimate` | Create a new estimate in FreeAgent |
| `freeagent_create_bill_with_attachment` | Create a bill with optional attachment in FreeAgent |
| `freeagent_create_contact` | Create a new contact in FreeAgent |
| `freeagent_create_bank_account` | Create a bank account in FreeAgent |
| `freeagent_create_a_timeslip` | Create a new timeslip in FreeAgent |
| `freeagent_cashflow_summary_for_a_given_date_range` | Get cashflow summary for a date range from FreeAgent |
| `freeagent_list_accounting_transactions` | List accounting transactions in FreeAgent |
| `freeagent_get_the_pl_summary` | Get the profit and loss summary from FreeAgent |

## Notes

- **No API key for FreeAgent itself** — ClawLink holds the OAuth token; the agent only holds your ClawLink credential.
- Not connected yet, or access expired? Re-run `npx @useclawlink/cli connect freeagent`.
- The action list above is a snapshot; `npx @useclawlink/cli actions freeagent` is always current.

## Resources

- ClawLink: https://claw-link.dev
- Docs: https://docs.claw-link.dev
- CLI: https://www.npmjs.com/package/@useclawlink/cli

---

**Powered by [ClawLink](https://claw-link.dev)** — connect 90+ apps to any AI agent.

