mcp-server-deel
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-server-deel List all contractors"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-server-deel
Production-quality MCP server for the Deel API — global HR, payroll, and contractor management.
Features
48 tools spanning contracts, workers, payments, invoices, documents, off-cycle payments, time-off, expenses, organizations, and compliance
Full TypeScript with strict mode — zero
anycastsPagination on every list endpoint
structuredContenton every tool responsereadOnlyHint: trueon all GET/search/list toolsWorks 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
Log into Deel
Navigate to Settings → Integrations → API Tokens
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_KEY3. Build
npm run build4. 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 typecheckAPI 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 toolsapprove_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_statusBRead-only
Get an overall compliance status summary for the organization or a specific worker/contract.
Inputs: country, worker_id, contract_id.
get_contractARead-only
Get a single contract by ID with full details.
Inputs: contract_id (required).
get_contract_documentsBRead-only
Retrieve all documents associated with a contract.
Inputs: contract_id (required), limit, offset.
get_documentBRead-only
Get details of a specific document including download URL.
Inputs: document_id (required).
get_document_templateBRead-only
Get a specific document template by ID.
Inputs: template_id (required).
get_entityCRead-only
Get details of a specific legal entity.
Inputs: entity_id (required).
get_expenseBRead-only
Get details of a specific expense report.
Inputs: expense_id (required).
get_invoiceBRead-only
Get a specific invoice by ID with full line item details.
Inputs: invoice_id (required).
get_off_cycle_paymentARead-only
Get details of a specific off-cycle payment.
Inputs: payment_id (required).
get_organizationBRead-only
Get the current organization's profile and settings.
Inputs: no named parameters.
get_paymentCRead-only
Get details of a specific payment by ID.
Inputs: payment_id (required).
get_payment_statusCRead-only
Check the current status of a payment.
Inputs: payment_id (required).
get_workerBRead-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_itemsBRead-only
List all compliance items and their status for the organization.
Inputs: type, limit, offset, status, +3 more.
list_contractsBRead-only
List all contracts in your Deel organization. Supports filtering by status, type, and worker.
Inputs: type, limit, offset, status, +2 more.
list_departmentsBRead-only
List all departments in the organization.
Inputs: limit, offset, parent_id.
list_documentsCRead-only
List all documents in the organization, with optional filters.
Inputs: type, limit, offset, status, +2 more.
list_document_templatesARead-only
List available document templates for creating contracts and agreements.
Inputs: type, limit, offset, country.
list_entitiesBRead-only
List legal entities belonging to the organization.
Inputs: limit, offset, country.
list_expensesCRead-only
List expense reports with optional filters.
Inputs: limit, offset, status, to_date, +3 more.
list_invoice_adjustmentsCRead-only
List adjustments (bonuses, deductions) for an invoice.
Inputs: invoice_id (required), limit, offset.
list_invoicesBRead-only
List invoices with optional filters by status, contract, or date range.
Inputs: limit, offset, status, to_date, +2 more.
list_off_cycle_paymentsBRead-only
List off-cycle payments (bonuses, commissions, etc.) with optional filters.
Inputs: limit, offset, status, to_date, +2 more.
list_payment_methodsBRead-only
List available payment methods for the organization.
Inputs: limit, offset.
list_paymentsCRead-only
List all payments with optional filters by status, contract, or date range.
Inputs: limit, offset, status, to_date, +2 more.
list_required_documentsARead-only
List required compliance documents for a worker, contract, or country.
Inputs: limit, offset, country, worker_id, +2 more.
list_time_off_policiesBRead-only
List all time-off policies configured in the organization.
Inputs: type, limit, offset, country.
list_time_off_requestsCRead-only
List time-off requests with optional filters by worker, status, or date range.
Inputs: limit, offset, status, to_date, +2 more.
list_workersCRead-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_workersCRead-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
Scored across 48 tools
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.
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.
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.
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
Related MCP Connectors
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
MCP server for Codat — companies, connections, invoices, bills and financial statements.
Discover and call 10,000+ production APIs from one MCP server. Pay-per-call billing for AI agents.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for PrismHR, enabling AI agents to automate payroll, benefits, compliance, and billing tasks with verified-schema tools and scope-gated consent.1848 PyPI4MIT
- AlicenseNot gradedqualityDmaintenanceA 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.3MIT
- AlicenseAqualityBmaintenanceAn MCP server that wraps the Check Payroll API, providing 263 tools for managing companies, employees, contractors, payrolls, tax configuration, and more.318MIT
- AlicenseNot gradedqualityDmaintenanceA 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