Repository navigation
Releases
mcp-freeagent 0.2.0
v0.2.0 (2026-11-08)
Features
- Read receipts and fill in expenses from them (50e287f)
- Month-end and VAT check, and director's loan account review (bc601b9)
Bug Fixes
- Refuse list pages over 50,000 characters (1a930e2)
Documentation
- Receipts, reviews and the director's loan prompt (a6a9c0b)
Install
Docker
docker run -d --name mcp-freeagent -p 8443:8443 \
-e PUBLIC_URL=https://freeagent-mcp.example.com \
-e OAUTH_SIGNING_KEY="$(openssl rand -hex 32)" \
-e FREEAGENT_CLIENT_ID=your-oauth-identifier \
-e FREEAGENT_CLIENT_SECRET=your-oauth-secret \
-e FREEAGENT_TOKEN_STORE=/data/tokens.json \
-v mcp-freeagent-data:/data \
-v /path/to/certs:/certs:ro \
-e TLS_CERT_PATH=/certs/fullchain.pem \
-e TLS_KEY_PATH=/certs/privkey.pem \
ghcr.io/trozz/mcp-freeagent:0.2.0Binary
Download the archive for your platform below, verify it with the matching .sha256 file (shasum -a 256 -c <file>.sha256), extract it and run ./mcp-freeagent with the same environment variables.
Connect
The FreeAgent service is at https://<your PUBLIC_URL host>/freeagent, and every service together at /mcp with tool names prefixed freeagent_.
Each person signs in with their own FreeAgent account through FreeAgent's OAuth; the server stores no API key. Register https://<your PUBLIC_URL host>/callback as a redirect URI of your app in the FreeAgent Developer Dashboard.
- claude.ai: add a custom connector for
https://<your PUBLIC_URL host>/freeagentand approve access at FreeAgent. - Claude Code:
claude mcp add --transport http freeagent https://<host>/freeagent, then/mcpto sign in.
Configuration reference: https://github.com/Trozz/mcp-freeagent#configuration
mcp-freeagent 0.1.3-dev.14
v0.1.3-dev.14 (2026-11-08)
Features
- Read receipts and fill in expenses from them (50e287f)
- Month-end and VAT check, and director's loan account review (bc601b9)
Bug Fixes
- Refuse list pages over 50,000 characters (1a930e2)
Documentation
- Receipts, reviews and the director's loan prompt (a6a9c0b)
Install
Docker
docker run -d --name mcp-freeagent -p 8443:8443 \
-e PUBLIC_URL=https://freeagent-mcp.example.com \
-e OAUTH_SIGNING_KEY="$(openssl rand -hex 32)" \
-e FREEAGENT_CLIENT_ID=your-oauth-identifier \
-e FREEAGENT_CLIENT_SECRET=your-oauth-secret \
-e FREEAGENT_TOKEN_STORE=/data/tokens.json \
-v mcp-freeagent-data:/data \
-v /path/to/certs:/certs:ro \
-e TLS_CERT_PATH=/certs/fullchain.pem \
-e TLS_KEY_PATH=/certs/privkey.pem \
ghcr.io/trozz/mcp-freeagent:0.1.3-dev.14Binary
Download the archive for your platform below, verify it with the matching .sha256 file (shasum -a 256 -c <file>.sha256), extract it and run ./mcp-freeagent with the same environment variables.
Connect
The FreeAgent service is at https://<your PUBLIC_URL host>/freeagent, and every service together at /mcp with tool names prefixed freeagent_.
Each person signs in with their own FreeAgent account through FreeAgent's OAuth; the server stores no API key. Register https://<your PUBLIC_URL host>/callback as a redirect URI of your app in the FreeAgent Developer Dashboard.
- claude.ai: add a custom connector for
https://<your PUBLIC_URL host>/freeagentand approve access at FreeAgent. - Claude Code:
claude mcp add --transport http freeagent https://<host>/freeagent, then/mcpto sign in.
Configuration reference: https://github.com/Trozz/mcp-freeagent#configuration
mcp-freeagent 0.1.2
v0.1.2 (2026-11-01)
Bug Fixes
- Leave signed attachment links out of tool results (9087909)
- Findings from testing against live FreeAgent (2f01f59)
- Follow FreeAgent's pages and find explanations awaiting approval (fc20ea0)
- Findings from testing writes against live FreeAgent (4c9c72f)
Documentation
- Add the mdBook documentation site with a CI build and link check (b535841)
Install
Docker
docker run -d --name mcp-freeagent -p 8443:8443 \
-e PUBLIC_URL=https://freeagent-mcp.example.com \
-e OAUTH_SIGNING_KEY="$(openssl rand -hex 32)" \
-e FREEAGENT_CLIENT_ID=your-oauth-identifier \
-e FREEAGENT_CLIENT_SECRET=your-oauth-secret \
-e FREEAGENT_TOKEN_STORE=/data/tokens.json \
-v mcp-freeagent-data:/data \
-v /path/to/certs:/certs:ro \
-e TLS_CERT_PATH=/certs/fullchain.pem \
-e TLS_KEY_PATH=/certs/privkey.pem \
ghcr.io/trozz/mcp-freeagent:0.1.2Binary
Download the archive for your platform below, verify it with the matching .sha256 file (shasum -a 256 -c <file>.sha256), extract it and run ./mcp-freeagent with the same environment variables.
Connect
The FreeAgent service is at https://<your PUBLIC_URL host>/freeagent, and every service together at /mcp with tool names prefixed freeagent_.
Each person signs in with their own FreeAgent account through FreeAgent's OAuth; the server stores no API key. Register https://<your PUBLIC_URL host>/callback as a redirect URI of your app in the FreeAgent Developer Dashboard.
- claude.ai: add a custom connector for
https://<your PUBLIC_URL host>/freeagentand approve access at FreeAgent. - Claude Code:
claude mcp add --transport http freeagent https://<host>/freeagent, then/mcpto sign in.
Configuration reference: https://github.com/Trozz/mcp-freeagent#configuration
mcp-freeagent 0.1.2-dev.9
v0.1.2-dev.9 (2026-11-01)
Bug Fixes
- Leave signed attachment links out of tool results (9087909)
Documentation
- Add the mdBook documentation site with a CI build and link check (b535841)
Install
Docker
docker run -d --name mcp-freeagent -p 8443:8443 \
-e PUBLIC_URL=https://freeagent-mcp.example.com \
-e OAUTH_SIGNING_KEY="$(openssl rand -hex 32)" \
-e FREEAGENT_CLIENT_ID=your-oauth-identifier \
-e FREEAGENT_CLIENT_SECRET=your-oauth-secret \
-e FREEAGENT_TOKEN_STORE=/data/tokens.json \
-v mcp-freeagent-data:/data \
-v /path/to/certs:/certs:ro \
-e TLS_CERT_PATH=/certs/fullchain.pem \
-e TLS_KEY_PATH=/certs/privkey.pem \
ghcr.io/trozz/mcp-freeagent:0.1.2-dev.9Binary
Download the archive for your platform below, verify it with the matching .sha256 file (shasum -a 256 -c <file>.sha256), extract it and run ./mcp-freeagent with the same environment variables.
Connect
The FreeAgent service is at https://<your PUBLIC_URL host>/freeagent, and every service together at /mcp with tool names prefixed freeagent_.
Each person signs in with their own FreeAgent account through FreeAgent's OAuth; the server stores no API key. Register https://<your PUBLIC_URL host>/callback as a redirect URI of your app in the FreeAgent Developer Dashboard.
- claude.ai: add a custom connector for
https://<your PUBLIC_URL host>/freeagentand approve access at FreeAgent. - Claude Code:
claude mcp add --transport http freeagent https://<host>/freeagent, then/mcpto sign in.
Configuration reference: https://github.com/Trozz/mcp-freeagent#configuration
mcp-freeagent 0.1.2-dev.12
v0.1.2-dev.12 (2026-11-01)
Bug Fixes
- Leave signed attachment links out of tool results (9087909)
- Findings from testing against live FreeAgent (2f01f59)
- Follow FreeAgent's pages and find explanations awaiting approval (fc20ea0)
- Findings from testing writes against live FreeAgent (4c9c72f)
Documentation
- Add the mdBook documentation site with a CI build and link check (b535841)
Install
Docker
docker run -d --name mcp-freeagent -p 8443:8443 \
-e PUBLIC_URL=https://freeagent-mcp.example.com \
-e OAUTH_SIGNING_KEY="$(openssl rand -hex 32)" \
-e FREEAGENT_CLIENT_ID=your-oauth-identifier \
-e FREEAGENT_CLIENT_SECRET=your-oauth-secret \
-e FREEAGENT_TOKEN_STORE=/data/tokens.json \
-v mcp-freeagent-data:/data \
-v /path/to/certs:/certs:ro \
-e TLS_CERT_PATH=/certs/fullchain.pem \
-e TLS_KEY_PATH=/certs/privkey.pem \
ghcr.io/trozz/mcp-freeagent:0.1.2-dev.12Binary
Download the archive for your platform below, verify it with the matching .sha256 file (shasum -a 256 -c <file>.sha256), extract it and run ./mcp-freeagent with the same environment variables.
Connect
The FreeAgent service is at https://<your PUBLIC_URL host>/freeagent, and every service together at /mcp with tool names prefixed freeagent_.
Each person signs in with their own FreeAgent account through FreeAgent's OAuth; the server stores no API key. Register https://<your PUBLIC_URL host>/callback as a redirect URI of your app in the FreeAgent Developer Dashboard.
- claude.ai: add a custom connector for
https://<your PUBLIC_URL host>/freeagentand approve access at FreeAgent. - Claude Code:
claude mcp add --transport http freeagent https://<host>/freeagent, then/mcpto sign in.
Configuration reference: https://github.com/Trozz/mcp-freeagent#configuration
mcp-freeagent 0.1.2-dev.11
v0.1.2-dev.11 (2026-11-01)
Bug Fixes
- Leave signed attachment links out of tool results (9087909)
- Findings from testing against live FreeAgent (2f01f59)
- Follow FreeAgent's pages and find explanations awaiting approval (fc20ea0)
Documentation
- Add the mdBook documentation site with a CI build and link check (b535841)
Install
Docker
docker run -d --name mcp-freeagent -p 8443:8443 \
-e PUBLIC_URL=https://freeagent-mcp.example.com \
-e OAUTH_SIGNING_KEY="$(openssl rand -hex 32)" \
-e FREEAGENT_CLIENT_ID=your-oauth-identifier \
-e FREEAGENT_CLIENT_SECRET=your-oauth-secret \
-e FREEAGENT_TOKEN_STORE=/data/tokens.json \
-v mcp-freeagent-data:/data \
-v /path/to/certs:/certs:ro \
-e TLS_CERT_PATH=/certs/fullchain.pem \
-e TLS_KEY_PATH=/certs/privkey.pem \
ghcr.io/trozz/mcp-freeagent:0.1.2-dev.11Binary
Download the archive for your platform below, verify it with the matching .sha256 file (shasum -a 256 -c <file>.sha256), extract it and run ./mcp-freeagent with the same environment variables.
Connect
The FreeAgent service is at https://<your PUBLIC_URL host>/freeagent, and every service together at /mcp with tool names prefixed freeagent_.
Each person signs in with their own FreeAgent account through FreeAgent's OAuth; the server stores no API key. Register https://<your PUBLIC_URL host>/callback as a redirect URI of your app in the FreeAgent Developer Dashboard.
- claude.ai: add a custom connector for
https://<your PUBLIC_URL host>/freeagentand approve access at FreeAgent. - Claude Code:
claude mcp add --transport http freeagent https://<host>/freeagent, then/mcpto sign in.
Configuration reference: https://github.com/Trozz/mcp-freeagent#configuration
mcp-freeagent 0.1.2-dev.10
v0.1.2-dev.10 (2026-11-01)
Bug Fixes
- Leave signed attachment links out of tool results (9087909)
- Findings from testing against live FreeAgent (2f01f59)
Documentation
- Add the mdBook documentation site with a CI build and link check (b535841)
Install
Docker
docker run -d --name mcp-freeagent -p 8443:8443 \
-e PUBLIC_URL=https://freeagent-mcp.example.com \
-e OAUTH_SIGNING_KEY="$(openssl rand -hex 32)" \
-e FREEAGENT_CLIENT_ID=your-oauth-identifier \
-e FREEAGENT_CLIENT_SECRET=your-oauth-secret \
-e FREEAGENT_TOKEN_STORE=/data/tokens.json \
-v mcp-freeagent-data:/data \
-v /path/to/certs:/certs:ro \
-e TLS_CERT_PATH=/certs/fullchain.pem \
-e TLS_KEY_PATH=/certs/privkey.pem \
ghcr.io/trozz/mcp-freeagent:0.1.2-dev.10Binary
Download the archive for your platform below, verify it with the matching .sha256 file (shasum -a 256 -c <file>.sha256), extract it and run ./mcp-freeagent with the same environment variables.
Connect
The FreeAgent service is at https://<your PUBLIC_URL host>/freeagent, and every service together at /mcp with tool names prefixed freeagent_.
Each person signs in with their own FreeAgent account through FreeAgent's OAuth; the server stores no API key. Register https://<your PUBLIC_URL host>/callback as a redirect URI of your app in the FreeAgent Developer Dashboard.
- claude.ai: add a custom connector for
https://<your PUBLIC_URL host>/freeagentand approve access at FreeAgent. - Claude Code:
claude mcp add --transport http freeagent https://<host>/freeagent, then/mcpto sign in.
Configuration reference: https://github.com/Trozz/mcp-freeagent#configuration
mcp-freeagent 0.1.1
v0.1.1 (2026-10-29)
Bug Fixes
- Attach receipts through single-use upload links (c058119)
Install
Docker
docker run -d --name mcp-freeagent -p 8443:8443 \
-e PUBLIC_URL=https://freeagent-mcp.example.com \
-e OAUTH_SIGNING_KEY="$(openssl rand -hex 32)" \
-e FREEAGENT_CLIENT_ID=your-oauth-identifier \
-e FREEAGENT_CLIENT_SECRET=your-oauth-secret \
-e FREEAGENT_TOKEN_STORE=/data/tokens.json \
-v mcp-freeagent-data:/data \
-v /path/to/certs:/certs:ro \
-e TLS_CERT_PATH=/certs/fullchain.pem \
-e TLS_KEY_PATH=/certs/privkey.pem \
ghcr.io/trozz/mcp-freeagent:0.1.1Binary
Download the archive for your platform below, verify it with the matching .sha256 file (shasum -a 256 -c <file>.sha256), extract it and run ./mcp-freeagent with the same environment variables.
Connect
The FreeAgent service is at https://<your PUBLIC_URL host>/freeagent, and every service together at /mcp with tool names prefixed freeagent_.
Each person signs in with their own FreeAgent account through FreeAgent's OAuth; the server stores no API key. Register https://<your PUBLIC_URL host>/callback as a redirect URI of your app in the FreeAgent Developer Dashboard.
- claude.ai: add a custom connector for
https://<your PUBLIC_URL host>/freeagentand approve access at FreeAgent. - Claude Code:
claude mcp add --transport http freeagent https://<host>/freeagent, then/mcpto sign in.
Configuration reference: https://github.com/Trozz/mcp-freeagent#configuration
mcp-freeagent 0.1.1-dev.5
v0.1.1-dev.5 (2026-10-29)
Bug Fixes
- Attach receipts through single-use upload links (c058119)
Install
Docker
docker run -d --name mcp-freeagent -p 8443:8443 \
-e PUBLIC_URL=https://freeagent-mcp.example.com \
-e OAUTH_SIGNING_KEY="$(openssl rand -hex 32)" \
-e FREEAGENT_CLIENT_ID=your-oauth-identifier \
-e FREEAGENT_CLIENT_SECRET=your-oauth-secret \
-e FREEAGENT_TOKEN_STORE=/data/tokens.json \
-v mcp-freeagent-data:/data \
-v /path/to/certs:/certs:ro \
-e TLS_CERT_PATH=/certs/fullchain.pem \
-e TLS_KEY_PATH=/certs/privkey.pem \
ghcr.io/trozz/mcp-freeagent:0.1.1-dev.5Binary
Download the archive for your platform below, verify it with the matching .sha256 file (shasum -a 256 -c <file>.sha256), extract it and run ./mcp-freeagent with the same environment variables.
Connect
The FreeAgent service is at https://<your PUBLIC_URL host>/freeagent, and every service together at /mcp with tool names prefixed freeagent_.
Each person signs in with their own FreeAgent account through FreeAgent's OAuth; the server stores no API key. Register https://<your PUBLIC_URL host>/callback as a redirect URI of your app in the FreeAgent Developer Dashboard.
- claude.ai: add a custom connector for
https://<your PUBLIC_URL host>/freeagentand approve access at FreeAgent. - Claude Code:
claude mcp add --transport http freeagent https://<host>/freeagent, then/mcpto sign in.
Configuration reference: https://github.com/Trozz/mcp-freeagent#configuration
mcp-freeagent 0.1.1-dev.4
v0.1.1-dev.4 (2026-10-29)
Bug Fixes
- Attach receipts through single-use upload links (c058119)
Install
Docker
docker run -d --name mcp-freeagent -p 8443:8443 \
-e PUBLIC_URL=https://freeagent-mcp.example.com \
-e OAUTH_SIGNING_KEY="$(openssl rand -hex 32)" \
-e FREEAGENT_CLIENT_ID=your-oauth-identifier \
-e FREEAGENT_CLIENT_SECRET=your-oauth-secret \
-e FREEAGENT_TOKEN_STORE=/data/tokens.json \
-v mcp-freeagent-data:/data \
-v /path/to/certs:/certs:ro \
-e TLS_CERT_PATH=/certs/fullchain.pem \
-e TLS_KEY_PATH=/certs/privkey.pem \
ghcr.io/trozz/mcp-freeagent:0.1.1-dev.4Binary
Download the archive for your platform below, verify it with the matching .sha256 file (shasum -a 256 -c <file>.sha256), extract it and run ./mcp-freeagent with the same environment variables.
Connect
The FreeAgent service is at https://<your PUBLIC_URL host>/freeagent, and every service together at /mcp with tool names prefixed freeagent_.
Each person signs in with their own FreeAgent account through FreeAgent's OAuth; the server stores no API key. Register https://<your PUBLIC_URL host>/callback as a redirect URI of your app in the FreeAgent Developer Dashboard.
- claude.ai: add a custom connector for
https://<your PUBLIC_URL host>/freeagentand approve access at FreeAgent. - Claude Code:
claude mcp add --transport http freeagent https://<host>/freeagent, then/mcpto sign in.
Configuration reference: https://github.com/Trozz/mcp-freeagent#configuration