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 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: mcp-server-check

Tool Inventory

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