How to Use the Deel MCP in Claude Code

Q: How do I use Claude Code to get a JSON list of all Deel contracts?

Run the command claude mcp call deel-mcp listcontracts. You can then pipe the output to a tool like jq to parse or format the JSON directly in your terminal.

Q: What's the command to add the Deel MCP server to Claude Code?

Run claude mcp add --transport http deel-mcp -- , replacing with the server endpoint from your Vinkius dashboard. Use claude mcp list to confirm it's connected.

Q: Can I use Claude Code to approve time-off requests in Deel?

No. The available tools like listtimeoff are for reading data only. You cannot use this server to approve, reject, or create any requests in Deel.

Pipe your Deel HR and payment data directly into your terminal. Perfect for shell scripts, cron jobs, and CI/CD financial checks.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Deel MCP to Claude Code

Create your Vinkius account to connect Deel to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Deel with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Payroll Audits from the Command Line

Use this MCP Server in your scripts to automate checks. Run a command to pull all payments for the last month with `list_payments` and pipe the JSON output to `jq` for filtering. You can create a cron job that runs nightly, uses `list_invoices` to find anything overdue, and then sends an alert to a Slack channel via a webhook. It's all headless, running on your schedule.

Use Deel Data in Your CI/CD Pipelines

Your deployment pipeline can now query your HR stack. For instance, a script could use `list_people` to confirm a developer is an active contractor before granting access to a staging environment. A single shell script can use `get_person` to find a team member's contracts, then `get_contract` to check their status before proceeding. This MCP server makes Deel data another resource for your infrastructure.

Command-Line Reporting for Deel

Forget the web UI. Get the exact data you need, formatted for your terminal. Chain commands together like `claude mcp call deel-mcp list_contracts | jq '.[] | .id'` to get a list of contract IDs. Then loop through those IDs in a script to fetch details with `get_contract` or associated tasks with `list_tasks`. It’s ideal for building custom reports or doing quick checks without leaving your terminal.

Setup guide

Set up Deel MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see deel-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Deel transactions." It will automatically discover and invoke the available Deel tools.

Terminal

claude mcp add --transport http deel-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Deel MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "deel-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Deel. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Deel now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Deel MCP in Claude Code

Run the command `claude mcp call deel-mcp list_contracts`. You can then pipe the output to a tool like `jq` to parse or format the JSON directly in your terminal.

Run `claude mcp add --transport http deel-mcp -- `, replacing `` with the server endpoint from your Vinkius dashboard. Use `claude mcp list` to confirm it's connected.

No. The available tools like `list_time_off` are for reading data only. You cannot use this server to approve, reject, or create any requests in Deel.

Yes, that's a perfect use case. A simple shell script can call `claude mcp call deel-mcp list_expenses`, filter the results for a 'pending' status, and alert you if any are found.

Your agent will handle expense reports, time-off requests, and payment statuses from Deel. Every operation runs inside a Vinkius V8 Isolate, and the data is streamed via your chosen transport without being stored on Vinkius servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript