Skip to main content
Glama

mcp-server-deel

Production-quality MCP server for the Deel API — global HR, payroll, and contractor management.

MCP TypeScript License: MIT

Features

  • 48 tools spanning contracts, workers, payments, invoices, documents, off-cycle payments, time-off, expenses, organizations, and compliance

  • Full TypeScript with strict mode — zero any casts

  • Pagination on every list endpoint

  • structuredContent on every tool response

  • readOnlyHint: true on all GET/search/list tools

  • Works with Claude Desktop, Cursor, and any MCP-compatible client

Related MCP server: Method CRM MCP Server

Tool Inventory

Module

Tools

Count

contracts

list_contracts, get_contract, create_contract, update_contract, terminate_contract, get_contract_documents

6

workers

list_workers, get_worker, invite_worker, update_worker, offboard_worker, search_workers

6

payments

list_payments, get_payment, create_payment, list_payment_methods, get_payment_status

5

invoices

list_invoices, get_invoice, approve_invoice, decline_invoice, list_invoice_adjustments

5

documents

list_documents, get_document, sign_document, list_document_templates, get_document_template

5

off_cycle_payments

list_off_cycle_payments, create_off_cycle_payment, get_off_cycle_payment, approve_off_cycle_payment

4

time_off

list_time_off_policies, list_time_off_requests, create_time_off_request, approve_time_off_request

4

expenses

list_expenses, get_expense, create_expense, approve_expense, decline_expense

5

organizations

get_organization, list_entities, get_entity, list_departments, create_department

5

compliance

list_compliance_items, get_compliance_status, list_required_documents

3

Total

48

Prerequisites

  • Node.js 18+

  • A Deel account with API access

  • A Deel API key (see Setup below)

Setup

1. Get a Deel API Key

  1. Log into Deel

  2. Navigate to Settings → Integrations → API Tokens

  3. Click Create Token and copy the generated key

2. Install and Configure

# Clone the repository
git clone https://github.com/BusyBee3333/deel-mcp-2026-complete.git
cd deel-mcp-2026-complete

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env and set your DEEL_API_KEY

3. Build

npm run build

4. Connect to Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "deel": {
      "command": "node",
      "args": ["/path/to/deel-mcp-2026-complete/dist/index.js"],
      "env": {
        "DEEL_API_KEY": "your_api_key_here"
      }
    }
  }
}

5. Connect to Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "deel": {
      "command": "node",
      "args": ["/path/to/deel-mcp-2026-complete/dist/index.js"],
      "env": {
        "DEEL_API_KEY": "your_api_key_here"
      }
    }
  }
}

Development

# Run in watch mode (requires tsx)
npm run dev

# Type-check only (no emit)
npm run typecheck

API Reference

This server wraps the Deel REST API v2. All requests are authenticated with a Bearer token.

Base URL: https://app.deel.com/api

License

MIT

Available Tools

48 tools
approve_expenseC

Approve a pending expense report.

Inputs: expense_id (required), notes.

approve_invoiceC

Approve a pending invoice for payment.

Inputs: invoice_id (required), notes.

approve_off_cycle_paymentC

Approve a pending off-cycle payment for processing.

Inputs: payment_id (required), notes.

approve_time_off_requestC

Approve a pending time-off request.

Inputs: request_id (required), notes.

create_contractC

Create a new contract in Deel.

Inputs: type (required), title (required), country (required), currency (required), +7 more.

create_departmentC

Create a new department in the organization.

Inputs: name (required), parent_id, description.

create_expenseC

Submit a new expense report.

Inputs: amount (required), category (required), currency (required), contract_id (required), +3 more.

create_off_cycle_paymentC

Create an off-cycle payment (bonus, commission, reimbursement, etc.).

Inputs: amount (required), reason (required), currency (required), contract_id (required), +2 more.

create_paymentC

Create a new payment for a contract.

Inputs: amount (required), currency (required), contract_id (required), description, +2 more.

create_time_off_requestC

Create a new time-off request for a worker.

Inputs: end_date (required), policy_id (required), worker_id (required), start_date (required), +1 more.

decline_expenseB

Decline a pending expense report.

Inputs: reason (required), expense_id (required).

decline_invoiceB

Decline a pending invoice with a reason.

Inputs: reason (required), invoice_id (required).

get_compliance_statusB
Read-only

Get an overall compliance status summary for the organization or a specific worker/contract.

Inputs: country, worker_id, contract_id.

get_contractA
Read-only

Get a single contract by ID with full details.

Inputs: contract_id (required).

get_contract_documentsB
Read-only

Retrieve all documents associated with a contract.

Inputs: contract_id (required), limit, offset.

get_documentB
Read-only

Get details of a specific document including download URL.

Inputs: document_id (required).

get_document_templateB
Read-only

Get a specific document template by ID.

Inputs: template_id (required).

get_entityC
Read-only

Get details of a specific legal entity.

Inputs: entity_id (required).

get_expenseB
Read-only

Get details of a specific expense report.

Inputs: expense_id (required).

get_invoiceB
Read-only

Get a specific invoice by ID with full line item details.

Inputs: invoice_id (required).

get_off_cycle_paymentA
Read-only

Get details of a specific off-cycle payment.

Inputs: payment_id (required).

get_organizationB
Read-only

Get the current organization's profile and settings.

Inputs: no named parameters.

get_paymentC
Read-only

Get details of a specific payment by ID.

Inputs: payment_id (required).

get_payment_statusC
Read-only

Check the current status of a payment.

Inputs: payment_id (required).

get_workerB
Read-only

Get detailed information about a specific worker.

Inputs: worker_id (required).

invite_workerC

Invite a new worker to join Deel.

Inputs: email (required), country (required), last_name (required), first_name (required), +3 more.

list_compliance_itemsB
Read-only

List all compliance items and their status for the organization.

Inputs: type, limit, offset, status, +3 more.

list_contractsB
Read-only

List all contracts in your Deel organization. Supports filtering by status, type, and worker.

Inputs: type, limit, offset, status, +2 more.

list_departmentsB
Read-only

List all departments in the organization.

Inputs: limit, offset, parent_id.

list_documentsC
Read-only

List all documents in the organization, with optional filters.

Inputs: type, limit, offset, status, +2 more.

list_document_templatesA
Read-only

List available document templates for creating contracts and agreements.

Inputs: type, limit, offset, country.

list_entitiesB
Read-only

List legal entities belonging to the organization.

Inputs: limit, offset, country.

list_expensesC
Read-only

List expense reports with optional filters.

Inputs: limit, offset, status, to_date, +3 more.

list_invoice_adjustmentsC
Read-only

List adjustments (bonuses, deductions) for an invoice.

Inputs: invoice_id (required), limit, offset.

list_invoicesB
Read-only

List invoices with optional filters by status, contract, or date range.

Inputs: limit, offset, status, to_date, +2 more.

list_off_cycle_paymentsB
Read-only

List off-cycle payments (bonuses, commissions, etc.) with optional filters.

Inputs: limit, offset, status, to_date, +2 more.

list_payment_methodsB
Read-only

List available payment methods for the organization.

Inputs: limit, offset.

list_paymentsC
Read-only

List all payments with optional filters by status, contract, or date range.

Inputs: limit, offset, status, to_date, +2 more.

list_required_documentsA
Read-only

List required compliance documents for a worker, contract, or country.

Inputs: limit, offset, country, worker_id, +2 more.

list_time_off_policiesB
Read-only

List all time-off policies configured in the organization.

Inputs: type, limit, offset, country.

list_time_off_requestsC
Read-only

List time-off requests with optional filters by worker, status, or date range.

Inputs: limit, offset, status, to_date, +2 more.

list_workersC
Read-only

List all workers in your Deel organization.

Inputs: limit, offset, status, country, +1 more.

offboard_workerC

Initiate the offboarding process for a worker.

Inputs: reason (required), last_day (required), worker_id (required), notes, +1 more.

search_workersC
Read-only

Search for workers by name or email.

Inputs: query (required), limit, offset.

sign_documentC

Sign a pending document on behalf of the authenticated user.

Inputs: document_id (required), signature.

terminate_contractC

Terminate an active contract.

Inputs: contract_id (required), termination_reason (required), last_day_of_work, severance_amount.

update_contractC

Update an existing contract's details.

Inputs: contract_id (required), title, amount, end_date, +2 more.

update_workerC

Update an existing worker's profile information.

Inputs: worker_id (required), job_title, last_name, first_name, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 48 tools

    Disambiguation4/5

    Most tools pair a clear action with a distinct Deel resource, so an agent can usually select correctly. However, the document and payment families contain several similar read/status tools, and get_payment vs get_payment_status can be confused.

    Naming Consistency5/5

    All tool names use consistent snake_case verb_noun phrasing (list_/get_/create_/update_/approve_/decline_), with only conventional singular/plural noun variation. No mixed naming conventions are present.

    Tool Count2/5

    At 48 tools, this exceeds the typical well-scoped range of 3–15 and feels heavy for a single MCP server. While Deel is a broad HR/payroll domain, many tools are partial CRUD sets rather than a tightly curated surface.

    Completeness3/5

    Core worker, contract, expense, and payment workflows have create/read/approve coverage, but several resources lack lifecycle operations. Departments, entities, time-off policies, payment methods, and time-off requests have notable missing update/delete/decline or creation operations.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for PrismHR, enabling AI agents to automate payroll, benefits, compliance, and billing tasks with verified-schema tools and scope-gated consent.
      18
      48 PyPI
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A production-ready MCP server for Method CRM API integration. It enables LLMs to interact with Method CRM data through tools for tables, files, users, events, and API key management.
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A comprehensive MCP server for BambooHR with 47 tools covering employee management, time off, reports, benefits, payroll, goals, training, files, and webhooks, plus 18 React-based UI apps.
      MIT