Repository navigation
mcp-freeagent 0.1.2-dev.9
Pre-release
Pre-release
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