Requirements:
- Python 3.10 or higher
Step 1. Install uv:
- MacOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
- Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Step 2. Configure Claude Desktop
- Download Claude Desktop.
- Launch Claude and go to Settings > Developer > Edit Config.
- Modify
claude_desktop_config.json
with:
1{ 2 "mcpServers": { 3 "Adfin": { 4 "command": "<home_path>/.local/bin/uv", 5 "args": [ 6 "--directory", 7 "<absolute_path_to_adfin_mcp_folder>", 8 "run", 9 "main_adfin_mcp.py" 10 ], 11 "env": { 12 "ADFIN_EMAIL": "<email>", 13 "ADFIN_PASSWORD": "<password>" 14 } 15 }, 16 "filesystem": { 17 "command": "<home_path>/.local/bin/uv", 18 "args": [ 19 "--directory", 20 "<absolute_path_to_adfin_mcp_folder>", 21 "run", 22 "filesystem.py" 23 ] 24 } 25 } 26}
- Relaunch Claude Desktop.
The first time you open Claude Desktop with these setting it may take 10-20 seconds before the Adfin tools appear in the interface due to the installation of the required packages and the download of the most recent Adfin API documentation.
Everytime you launch Claude Desktop, the most recent Adfin API tools are made available to your AI assistant.
Step 3. Launch Claude Desktop and let your assistant help you
Examples
Request a credit control status
1Give me a credit control status check.
Create a new invoice
1Create a new invoice for 60 GBP for Abc Def that is due in a week. His email is [email protected].
Ask the assistant to upload multiple invoices from your folder
1Upload all pdf invoices from the invoices folder from my Desktop.