Skip to content

Integrations

Nufinox integrates with external project management tools (Asana, Linear) to sync tasks, and with Minimax for accounting.

Project Management — Asana

Connecting

  1. Go to Settings → Project Management
  2. Click Add connection and select Asana
  3. Enter your Asana personal access token. You can generate one in your Asana account under Profile → Apps → Developer apps
  4. Save the connection

Mapping Projects to Clients

Once connected, you need to tell Nufinox which Asana workspace corresponds to which client.

  1. On the Project Management settings page, open your Asana connection
  2. Click Add mapping
  3. Enter the Asana workspace ID and select the corresponding client in Nufinox
  4. Save

You can add multiple mappings for different workspaces.

How Syncing Works

Each day, Nufinox fetches tasks from Asana that are assigned to any of your employees (matched by email address). Tasks are upserted — new tasks are created, existing tasks are updated.

The task's assignee is matched to an employee by comparing the Asana user's email to your employees' personal email addresses.

Project Management — Linear

Connecting

  1. Go to Settings → Project Management
  2. Click Add connection and select Linear
  3. Enter your Linear API key. Generate one in Linear under Settings → API → Personal API keys
  4. Save the connection

Mapping Teams to Clients

  1. On the Project Management settings page, open your Linear connection
  2. Click Add mapping
  3. Enter the Linear team key (e.g. ENG) and select the corresponding client in Nufinox
  4. Save

How Syncing Works

Nufinox fetches issues from Linear for each mapped team, filtered to assignees whose email matches your employees. Tasks are upserted daily.

For Linear issues, Nufinox also looks for attached pull request or merge request URLs and stores them in the task's Implementation link field.

Removing a Project Management Connection

Deleting a connection in Settings removes the connection and all tasks that were synced through it. Work logs attached to those tasks are deleted too. This is irreversible — only remove a connection if you are sure.

Accounting — Minimax

Connecting

  1. Go to Settings → Accounting
  2. Click Add connection
  3. Enter your Minimax credentials:
  4. Client ID and Client secret — from your Minimax API application
  5. Username and Password — your Minimax login credentials
  6. Organisation ID — your Minimax organisation ID
  7. Enter the Minimax configuration IDs for invoices:
  8. Template ID — the invoice template to use
  9. Item ID — the line item definition for services
  10. VAT rate ID — the applicable VAT rate
  11. Save the connection

Using Minimax

Once connected, invoices for clients that have an Accounting customer ID set can be pushed to Minimax as draft invoices. See Invoices for details.

API Token (MCP)

Nufinox exposes a Model Context Protocol (MCP) endpoint that allows AI tools to query your data. To use it:

  1. Go to Settings → API Token
  2. Copy the token and configure it in your MCP client (e.g. Claude Desktop)
  3. The MCP server URL is https://app.nufinox.com/mcp

The endpoint exposes: employees, clients, tasks, work logs, and invoices. Members only see their own work logs. Admins see everything.

To regenerate the token (e.g. if it is compromised), click Regenerate on the API Token page. The old token stops working immediately.