Workable MCP for AI Agents

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/openai @ai-sdk/mcp

Install the Composio SDK and Claude Agent SDK

Create Tool Router Session

typescript

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

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);

Initialize the Composio client and create a Tool Router session

Connect to AI Agent

typescript

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

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'List all candidates for open positions' }],
  stopWhen: stepCountIs( 5 )
});

console.log(`Agent: ${text}`);

Use the MCP server with your AI agent

SETUP GUIDE

Connect Workable API Tool with your Agent

Install Composio

typescript

npm install @composio/openai

Install the Composio SDK

Initialize Composio and Create Tool Router Session

typescript

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

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');

Import and initialize Composio client, then create a Tool Router session

Execute Workable Tools via Tool Router with Your Agent

typescript

const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List all active job openings in Workable'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);

Get tools from Tool Router session and execute Workable actions with your Agent

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

OpenAI Agents SDK

Use Workable MCP with OpenAI Agents SDK

Claude Agents SDK

Use Workable MCP with Claude Agents SDK

Claude Code

Use Workable MCP with Claude Code

Claude Cowork

Use Workable MCP with Claude Cowork

Codex

Use Workable MCP with Codex

OpenClaw

Use Workable MCP with OpenClaw

Hermes

Use Workable MCP with Hermes

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

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.

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.

Breathe HR

Api Key

Breathe HR is cloud-based HR software for SMEs to manage employee data, absences, and performance. It simplifies HR admin, making it easy to keep employee records accurate and up to date.

FAQ

Frequently asked questions

Yes, Workable requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

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

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

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

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 for AI Agents

Try Workable now

Supported Tools

Connect Workable MCP Tool with your Agent

Install Composio

Create Tool Router Session

Connect to AI Agent

Connect Workable API Tool with your Agent

Install Composio

Initialize Composio and Create Tool Router Session

Execute Workable Tools via Tool Router 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

OpenAI Agents SDK

Claude Agents SDK

Claude Code

Claude Cowork

Codex

OpenClaw

Hermes

Google ADK

Langchain

AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

Autogen

Explore Other Toolkits

Ashby

Async interview

Bamboohr

Breathe HR

Frequently asked questions

Do I need my own developer credentials to use Workable with Composio?+

Can I use multiple toolkits together?+

Is Composio secure?+

What if the API changes?+

Start with Workable.It takes 30 seconds.