Connector guide2-minute read9 MCP toolsEnglish · Deutsch · Italiano

How to Connect Workable to Gemini — via MCP

Manage Workable ATS (candidates, jobs, members, stages, comments) from any AI agent. 9 tools, Bearer token auth.

HCBy HelpCode teamUpdated 2 min read Open source on GitHub

No credit card · 7-day trial · Self-host alternative available

MCP connector

Workable

Manage Workable ATS (candidates, jobs, members, stages, comments) from any AI agent. 9 tools, Bearer token auth.

Tools

9

Region

INTL

Category

HR

Authentication

Bearer Token

Required env vars

WORKABLE_SUBDOMAINWORKABLE_ACCESS_TOKEN
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Source-available BSL-1.1
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

No install? Use cloud.anythingmcp.com directly.

Sign in, install the Workable in one click, paste the credentials, mint an MCP API key — done. No Docker, no git clone, no local server to run.

Open Cloud

TL;DR

Manage Workable ATS (candidates, jobs, members, stages, comments) from any AI agent. 9 tools, Bearer token auth.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Workable, paste your credentials, mint an MCP API key — done. No Docker, no git clone, no local server.

Workable + Gemini

Manage Workable ATS (candidates, jobs, members, stages, comments) from any AI agent. 9 tools, Bearer token auth.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

WORKABLE_SUBDOMAIN, WORKABLE_ACCESS_TOKEN

Step 1 — Get credentials

This connector wraps the Workable Hiring API (per-subdomain — yoursub.workable.com/spi/v3).

Setup:

  1. Log into your Workable account → top-right avatar → Integrations → Workable API → Generate access token.
  2. Note your subdomain (the part before .workable.com).
  3. Set WORKABLE_SUBDOMAIN and WORKABLE_ACCESS_TOKEN.

Authentication: Authorization: Bearer ${WORKABLE_ACCESS_TOKEN}.

Per-tenant baseUrl: https://${WORKABLE_SUBDOMAIN}.workable.com/spi/v3. Substituted at import time.

Job 'shortcode': Workable identifies jobs by short hash strings (AC123ABCDE) in URLs/API. Use workable_list_jobs to discover.

…(continued in the in-app connector instructions)

Step 2 — Install the adapter

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

Step 3 — Add the connector in Gemini

Gemini CLI reads MCP servers from ~/.gemini/settings.json (or %APPDATA%\gemini\settings.json on Windows). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" }
    }
  }
}
  1. Get your MCP API key from AnythingMCP → Profile → MCP API Keys → New Key.
  2. Save the file and restart gemini.
  3. Run /mcp inside the Gemini CLI — Workable should be listed as available.
  4. Vertex AI Studio: pass https://cloud.anythingmcp.com/mcp to the tools array of your request with the same Bearer header.

Available tools

ToolWhat it does
workable_account_infoReturns the account info (subdomain, name, summary)
workable_list_jobsList jobs
workable_get_jobGet a single job by shortcode with full description + requirements + benefits
workable_list_candidatesList candidates for a job
workable_get_candidateGet one candidate by ID with full profile + answers to job questions
workable_create_candidateCreate a candidate on a job (sourced / referral)
workable_move_candidate_stageMove a candidate to a different pipeline stage
workable_disqualify_candidateDisqualify (reject) a candidate with a reason
workable_list_stagesList pipeline stages defined in the account

FAQ

Does Gemini 1.5 Pro or 2.x support MCP? Yes — Gemini CLI ≥ 0.4 and Vertex AI tools API both accept MCP httpUrl connectors with Bearer headers.

Next steps

Was this guide helpful?

Ready to ship

Your Workable agent is one click away.

Install the connector, paste the key, prompt Gemini. Free for 7 days, no credit card.

Related guides