# How to connect ZipRecruiter MCP to Claude ```json { "title": "How to connect ZipRecruiter MCP to Claude", "toolkit": "ZipRecruiter MCP", "toolkit_slug": "ziprecruiter_mcp", "framework": "Claude Cowork", "framework_slug": "claude-cowork", "url": "https://composio.dev/toolkits/ziprecruiter_mcp/framework/claude-cowork", "markdown_url": "https://composio.dev/toolkits/ziprecruiter_mcp/framework/claude-cowork.md", "updated_at": "2026-10-04T17:47:09.863Z" } ``` ## Introduction Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf. This guide walks you through the easiest and most secure way to connect your ZipRecruiter account to Claude via Composio Connect, enabling it to find remote software jobs near Austin, compare salaries for data analyst roles, search entry-level marketing jobs in Chicago, and more such actions on your behalf without compromising your account security. Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three. ## Also integrate ZipRecruiter MCP with - [ChatGPT](https://composio.dev/toolkits/ziprecruiter_mcp/framework/chatgpt) - [Grok Bot](https://composio.dev/toolkits/ziprecruiter_mcp/framework/grok-bot) ## Connect ZipRecruiter MCP to Claude Cowork ### Connecting ZipRecruiter to Claude Web, Desktop, and Cowork Two ways to add the Composio connector. Pick whichever you prefer. ### 1. Add with one click Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2. [Add to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Composio&connectorUrl=https%3A%2F%2Fconnect.composio.dev%2Fmcp) ### Add manually In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top. Click Add custom connector and paste in the Composio MCP server URL: ```bash https://connect.composio.dev/mcp ``` ## What is the ZipRecruiter MCP server, and what's possible with it? The ZipRecruiter MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to ZipRecruiter. It provides structured and secure access to job listings across ZipRecruiter's marketplace, so your agent can search, browse, find, and recommend relevant opportunities on your behalf. - Role-based job search: Have your agent find job listings that match a specific title, profession, or area of expertise. - Location-focused opportunities: Direct your agent to search for openings in a preferred city, region, or other location. - Salary-based discovery: Instruct your agent to look for roles that meet your salary requirements. - Internship and gig searches: Let the agent find internships, gigs, and other types of work that fit your request. - Personalized job recommendations: Have your agent recommend relevant listings based on your preferred role, location, and salary. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `ZIPRECRUITER_MCP_SEARCH_JOBS` | Search jobs | Use this tool whenever the user asks to find, browse, view, recommend, or search for jobs, roles, openings, gigs, internships, or job listings. It only shows jobs that are within the United States or Canada. Guidelines: - Do not provide fields unless the user explicitly provides them. - The tool provides the search results all in one list, so if the user intends to search for multiple job roles, it may be better to invoke the tool for each job role separately. - If the user has not provided a location and is not asking for remote jobs, ask the user for a location before calling this tool. If you call without a location, results will default to a United States-wide search and the user will be warned. Notes: - When provided radius_miles, jobs will be included in the result if their location's boundaries approximately fall within radius miles of the requested location's boundaries. - If a salary range is provided, a job will be included in the results if the job's salary range overlaps with the requested salary range. | ## Supported Triggers None listed. ## Troubleshooting ### 1. Why does Claude not use the Composio connector for ZipRecruiter? The connector can show as connected, but Claude must use it in each ZipRecruiter conversation. - Click + at the lower left of the chat, or type /. - Hover Connectors. - Turn on Composio. - Ask Claude to connect to ZipRecruiter again. ### 2. Why does Claude show an MCP server error before ZipRecruiter connects? Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for ZipRecruiter. - Check that the connector URL is https://connect.composio.dev/mcp. - Connectors run from Anthropic's cloud, so your device network is usually not the problem. - Add the connector again from Customize > Connectors, then ask Claude to connect ZipRecruiter. - If it fails again, send the error and the ofid_ reference id to support@composio.dev. ### 3. Why does the ZipRecruiter authorization link not work? The Composio connector is one server. Your ZipRecruiter account connects separately when Claude asks for it. - If the browser does not open, or the link expires, ask Claude to retry the ZipRecruiter connection. - Composio creates a fresh ZipRecruiter authorization link. - Open that link in your browser and finish the ZipRecruiter sign-in. ### 4. Why do ZipRecruiter actions fail after they worked before? The ZipRecruiter connection can expire or lose permission. - Ask Claude to inspect the ZipRecruiter connection. - If the connection is unhealthy, disconnect it when Claude prompts you. - Reconnect the ZipRecruiter account and retry the action. - If Claude shows a permission prompt, approve it before Claude changes data in ZipRecruiter. - If the action still fails with a permission error, check that the connected account has that permission in ZipRecruiter itself. ### 5. How do I switch to a different ZipRecruiter account? Claude can manage the ZipRecruiter connection for you. - Ask Claude to disconnect or delete the current ZipRecruiter account. - Ask Claude to connect ZipRecruiter again. - Open the new Composio authorization link for ZipRecruiter. - Sign in with the other ZipRecruiter account in the browser. - After the account connects, ask Claude to retry the ZipRecruiter task. ### 6. Why is my ZipRecruiter connection missing in Claude Desktop or on a Team plan? The connector belongs to your Claude account, so your ZipRecruiter connection works in Claude Web, Desktop, and Cowork. - In Claude Desktop, open Customize > Connectors. - Next to Composio, click ⋮ and click Clear cache. - If ZipRecruiter tools still do not appear, click ⋮, disconnect, remove the connector, and add it again. - On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect ZipRecruiter. ## Creating MCP Server - Stand-alone vs Composio SDK The ZipRecruiter MCP server connects Claude Web, Desktop, and Cowork to your ZipRecruiter account through Composio. Once connected, Claude can use the available ZipRecruiter tools and triggers to complete tasks on your behalf. ## Complete Code None listed. ## How to build ZipRecruiter MCP Agent with another framework - [ChatGPT](https://composio.dev/toolkits/ziprecruiter_mcp/framework/chatgpt) - [Grok Bot](https://composio.dev/toolkits/ziprecruiter_mcp/framework/grok-bot) ## Related Toolkits - [Ashby](https://composio.dev/toolkits/ashby) - Ashby is an applicant tracking system that handles job postings, candidate management, and hiring analytics. - [7shifts](https://composio.dev/toolkits/7shifts) - 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](https://composio.dev/toolkits/async_interview) - Async interview is an on-demand video interview platform for streamlined hiring. Candidates record responses on their schedule, so employers can review anytime. - [Bamboohr](https://composio.dev/toolkits/bamboohr) - 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](https://composio.dev/toolkits/breathehr) - 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. - [Breezy Hr](https://composio.dev/toolkits/breezy_hr) - Breezy HR is a recruiting and applicant tracking platform for managing jobs, candidates, pipelines, and hiring teams. It helps teams move faster from job posting to offer without losing track of applicants. - [Connecteam](https://composio.dev/toolkits/connecteam) - Connecteam is a workforce management platform for deskless teams, streamlining operations, HR, and team communication. It helps businesses save time by automating scheduling, time tracking, and staff engagement tasks. - [ContactOut](https://composio.dev/toolkits/contactout) - ContactOut is a professional profile enrichment and contact discovery API. Find and verify email addresses to power recruiting, sales, and outreach. - [Coresignal](https://composio.dev/toolkits/coresignal) - Coresignal is a real-time public web data platform for employee, company, and professional profile intelligence. It helps teams access fresh workforce data for research, recruiting, sales, and market analysis. - [Dice MCP](https://composio.dev/toolkits/dice_mcp) - Dice MCP is an MCP server for searching Dice's tech-job database by role, company, location, and employment type. It helps agents find relevant tech roles fast with conversational filters. - [Greenhouse](https://composio.dev/toolkits/greenhouse) - Greenhouse is applicant tracking and recruiting software for managing jobs, candidates, interviews, and hiring workflows. It helps recruiting teams move faster with structured pipelines, collaboration tools, and hiring data in one place. - [Gusto](https://composio.dev/toolkits/gusto) - Gusto is a payroll, benefits, and HR platform for small and medium businesses. It helps teams run payroll, manage people, and stay compliant with less busywork. - [Hireflix](https://composio.dev/toolkits/hireflix) - Hireflix is a one-way video interview platform for hiring teams. It helps teams manage positions, candidate interviews, templates, and branded hiring workflows in one place. - [HR Partner](https://composio.dev/toolkits/hr_partner) - HR Partner is a human resources platform for managing employee records, leave, recruitment, performance, timesheets, and expenses. Use it to centralize HR workflows, automate manual HR tasks, and keep employee data organized. - [Job Search (Rapid API)](https://composio.dev/toolkits/job_search) - Job Search (Rapid API) is a unified service that searches approved job-listing sources via RapidAPI hosts. Use it to aggregate and query listings across providers with a single API. - [Lever](https://composio.dev/toolkits/lever) - Lever is an applicant tracking system that blends sourcing, CRM, and analytics for recruiting. It helps companies scale hiring with collaborative workflows and actionable insights. - [Personio](https://composio.dev/toolkits/personio) - Personio is an HR platform for managing employee records, attendance, absences, projects, and documents. It centralizes HR data and streamlines workforce administration for teams and HR leaders. - [Recruitee](https://composio.dev/toolkits/recruitee) - Recruitee is collaborative hiring software that centralizes recruitment tasks for teams. It streamlines sourcing, interviewing, and hiring so you can fill roles faster. - [Remote retrieval](https://composio.dev/toolkits/remote_retrieval) - Remote retrieval is a logistics automation tool for managing laptop and monitor returns. It streamlines return tracking, saving time and hassle for IT and ops teams. - [Sap successfactors](https://composio.dev/toolkits/sap_successfactors) - Sap successfactors is a cloud-based human capital management suite for HR, payroll, recruiting, and talent management. It helps organizations centralize employee data and streamline the entire employee lifecycle. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and ZipRecruiter MCP? With a standalone ZipRecruiter MCP server, the agents and LLMs can only access a fixed set of ZipRecruiter tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from ZipRecruiter and many other apps based on the task at hand, all through a single MCP endpoint. ### Can I use Tool Router MCP with Claude Cowork? Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right ZipRecruiter tools. ### Can I manage the permissions and scopes for ZipRecruiter while using Tool Router? Yes, absolutely. You can configure which ZipRecruiter scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do. ### How safe is my data with Composio Tool Router? All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your ZipRecruiter data and credentials are handled as safely as possible. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)