Workable MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Workable MCP or direct API to post jobs, manage candidates, update employee records, and automate HR workflows through natural language.

Get started for free Get a demo

Workable

Oauth2Api Key

Workable is an all-in-one HR software platform that streamlines hiring, employee management, and payroll. It helps teams simplify recruiting, onboarding, and staff operations in one place.

37 Tools

Try Workable now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND

Workable

Enter ↵

Try asking

TOOLS

Supported Tools

Every Workable action and event your agent gets out of the box.

Create Employee

Tool to create an employee in your Workable account.

Delete Department

Tool to delete a department.

Delete Subscription

Tool to unsubscribe from an event by deleting a webhook subscription.

Get Account

Tool to return the specified account.

Get Accounts

Retrieves all Workable accounts (organizations) accessible to the authenticated user.

Get Background Check Packages

Tool to retrieve a list of available background check packages from a specified provider.

Get Background Check Providers

Retrieves a list of background check providers integrated with your Workable account.

Get Candidates

Retrieve a list of candidates across all jobs in the organization.

Get Employee

Tool to retrieve detailed information for a specific employee by ID.

Get Events

Retrieve a collection of scheduled events (calls, interviews, meetings) from the Workable account.

Get Jobs

Retrieves a paginated list of jobs from your Workable account.

Get Legal Entities

Tool to retrieve a collection of your account legal entities.

Get Members

Retrieve a paginated list of Workable account members with their roles and permissions.

Get recruiters

Retrieves external recruiters from your Workable account.

Get Requisitions

Tool to retrieve a collection of requisitions in the account.

Get Stages

Tool to retrieve a collection of your recruitment pipeline stages.

Get Subscriptions

Retrieves all webhook subscriptions configured in your Workable account.

List Custom Attributes

Tool to retrieve all custom attributes configured in the Workable account.

List Departments

Tool to retrieve all departments from your Workable account.

List Disqualification Reasons

Tool to retrieve a collection of account's disqualification reasons.

List Employee Fields

Tool to retrieve a collection of your account's employee field definitions.

List Employees

Tool to retrieve a collection of account employees.

List Permission Sets

Tool to retrieve a collection of your account permission sets.

List Public Jobs

Tool to return a collection of public jobs for an account.

List Public Locations

Tool to retrieve a collection of locations where a Workable account has public job postings.

List Time Off Balances

Retrieves all time off balances for an employee across all time off categories.

List Time Off Categories

Tool to retrieve all time off categories configured for your account.

List Work Schedules

Tool to retrieve a collection of work schedules configured in your Workable account.

Update Background Check Status

Updates the status and results of an existing background check in a candidate's timeline.

Merge Department

Tool to merge a department into another.

Create Department

Tool to create a department in your account.

Enable Member

Enable (restore) a deactivated Workable account member to active status.

Invite Member

Tool to invite a member to your Workable account.

Update Department

Tool to update an existing department in your account.

Update Member

Updates a Workable account member's details including roles, name, headline, email, and collaboration rules.

Update Employee

Tool to update an existing employee in Workable.

Upload Employee Documents

Tool to upload a list of documents for a specific employee.

SETUP GUIDE

Connect Workable MCP Tool with your Agent

Install Composio

typescript

npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai

Install the Composio SDK and your agent framework

Create a session with MCP enabled

typescript

import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["workable"],
  mcp: true,
});

Create a session scoped to Workable and read its MCP URL and headers

Connect your agent to the MCP server

typescript

import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all active job openings in Workable",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();

Pass the session's MCP URL and headers to your agent and run a Workable request

SETUP GUIDE

Connect Workable API Tool with your Agent

Install Composio

typescript

npm install @composio/core @composio/openai openai

Install the Composio SDK, the OpenAI provider, and the OpenAI SDK

Create a Composio session

typescript

import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["workable"] });
const tools = await session.tools();

Initialize Composio with the OpenAI Responses provider and create a session scoped to Workable

Run Workable tools with your agent

typescript

let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all active job openings in Workable" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);

Send a request, execute the Workable tool calls through the session, and print the final answer

Why Use Composio?

AI Native Workable Integration

Supports both Workable MCP and direct API based integrations
Structured, LLM-friendly schemas for reliable tool execution
Rich coverage for reading, writing, and querying your Workable data

Managed Auth

Built-in OAuth handling with automatic token refresh and rotation
Central place to manage, scope, and revoke Workable access
Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

Tools are tuned using real error and success rates to improve reliability over time
Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

Fine-grained RBAC so you control which agents and users can access Workable
Scoped, least privilege access to Workable resources
Full audit trail of agent actions to support review and compliance

FRAMEWORKS

Use Workable with any AI Agent Framework

Choose a Framework you want to connect Workable with

Claude Code

Use Workable MCP with Claude Code

Claude Cowork

Use Workable MCP with Claude Cowork

OpenAI Agents SDK

Use Workable MCP with OpenAI Agents SDK

Claude Agents SDK

Use Workable MCP with Claude Agents SDK

Codex

Use Workable MCP with Codex

OpenClaw

Use Workable MCP with OpenClaw

Hermes

Use Workable MCP with Hermes

Atomic Agent

Use Workable MCP with Atomic Agent

Google ADK

Use Workable MCP with Google ADK

Langchain

Use Workable MCP with Langchain

AI SDK

Use Workable MCP with AI SDK

Mastra AI

Use Workable MCP with Mastra AI

LlamaIndex

Use Workable MCP with LlamaIndex

CrewAI

Use Workable MCP with CrewAI

Pydantic AI

Use Workable MCP with Pydantic AI

Autogen

Use Workable MCP with Autogen

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Ashby

Api Key

Ashby is an applicant tracking system that handles job postings, candidate management, and hiring analytics.

7shifts

Api Key

7shifts is a restaurant team management platform for scheduling, time clocks, payroll, and team communication. It helps operators keep labor, shifts, and staff workflows organized in one place.

Async interview

Api Key

Async interview is an on-demand video interview platform for streamlined hiring. Candidates record responses on their schedule, so employers can review anytime.

Bamboohr

Oauth2Api Key

BambooHR is a cloud-based HR management platform for small and mid-sized businesses. It streamlines employee data, HR workflows, and reporting in one easy interface.

FAQ

Frequently asked questions

Workable requires connections to go through your own OAuth app. You register it once with Workable, add its client ID and secret in the Composio dashboard, and from then on everyone connects by signing in to Workable as usual. Composio handles the rest of the flow and the token refresh.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Workable connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

When you connect a Workable account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Workable as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Exactly the ones Workable lists on its consent screen when you connect. Review that screen before approving. If you connect a work account, your Workable administrator may need to approve the app first, and you can revoke the access inside Workable whenever you want.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Workable connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

Composio refreshes Workable tokens automatically, so day to day you do nothing. If you revoke access inside Workable, or Workable invalidates the session, the connection shows as expired in Composio and the agent stops acting on that account until you reconnect it, which is a single sign-in.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, which covers most personal Workable use. Paid plans add higher limits and team features. Your Workable plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Workable accounts).

With Composio, you connect Workable once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Workable.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Workable tool your agent needs.Free to start.

Start building

Workable MCP server for AI agents and assistants

Try Workable now

Supported Tools

Connect Workable MCP Tool with your Agent

Install Composio

Create a session with MCP enabled

Connect your agent to the MCP server

Connect Workable API Tool with your Agent

Install Composio

Create a Composio session

Run Workable tools with your agent

Why Use Composio?

AI Native Workable Integration

Managed Auth

Agent Optimized Design

Enterprise Grade Security

Use Workable with any AI Agent Framework

Claude Code

Claude Cowork

OpenAI Agents SDK

Claude Agents SDK

Codex

OpenClaw

Hermes

Atomic Agent

Google ADK

Langchain

AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

Autogen

Rolling this out across your team?

Explore Other Toolkits

Ashby

7shifts

Async interview

Bamboohr

Frequently asked questions

Do I need my own Workable developer credentials or OAuth app?+

Can I use multiple toolkits together?+

Is Composio secure with my Workable account?+

What if the API changes?+

Does the agent act as me inside Workable?+

Which Workable permissions does Composio get?+

Can I use multiple Workable accounts with Claude and ChatGPT?+

What happens when my Workable access expires or I revoke it?+

Does using Workable through Composio cost extra?+

How is Composio different from the Workable connectors already built into Claude and ChatGPT?+

Start with Workable.It takes 30 seconds.