Adfin

You deploy an MCP server that integrates Adfin tools with Claude Desktop, enabling your AI assistant to run Adfin MCP workflows like credit control, invoicing, and file operations directly from the desktop environment.

How to use

To use the server, configure Claude Desktop to start each Adfin MCP tool as a separate local process and then interact with those tools through natural language prompts. The first time you launch Claude Desktop with these settings, you may see a short delay while dependencies install and the latest Adfin API documentation is fetched. After startup, the Adfin tools become available to your AI assistant for tasks such as checking credit control status, creating invoices, and uploading multiple invoices from a folder.

What you can do with the integrated MCP tools include: {credit control status} to check current credit positions, {Create a new invoice for 60 GBP for Abc Def that is due in a week. His email is abc.def@example.com} to generate invoices, and {Upload all pdf invoices from the invoices folder from my Desktop} to batch process invoices from your local files.

How to install

Prerequisites: Python 3.10 or higher must be installed on your machine.

Install uv on your platform.

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Configure Claude Desktop for Adfin MCP

Open Claude Desktop and navigate to Settings > Developer > Edit Config. Add the following configuration to connect the Adfin MCP tools.

{
  "mcpServers": {
    "Adfin": {
      "command": "<home_path>/.local/bin/uv",
      "args": [
        "--directory",
        "<absolute_path_to_adfin_mcp_folder>",
        "run",
        "main_adfin_mcp.py"
      ],
      "env": {
        "ADFIN_EMAIL": "<email>",
        "ADFIN_PASSWORD": "<password>"
      }
    },
    "filesystem": {
      "command": "<home_path>/.local/bin/uv",
      "args": [
        "--directory",
        "<absolute_path_to_adfin_mcp_folder>",
        "run",
        "filesystem.py"
      ]
    }
  }
}

Relaunch Claude Desktop

Close and reopen Claude Desktop to apply the new configuration. The first launch may take 10-20 seconds as dependencies install and the latest Adfin API documentation is downloaded.

Examples of usage after setup

Examples you can try from Claude Desktop after startup include issuing natural language requests that trigger the Adfin MCP tools, such as checking credit control status, creating invoices, and uploading invoices from a local folder.