Ashby Automation
Automate recruiting and hiring workflows in Ashby -- manage candidates, jobs, applications, interviews, and notes through natural language commands.
- License 许可
- MIT
- 最近更新
- 2026-11-03
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- Ashby Automation
- requires
- { "mcp": [ "rube" ] }
- description
- Automate recruiting and hiring workflows in Ashby -- manage candidates, jobs, applications, interviews, and notes through natural language commands.
03 SKILL.md 正文
Ashby Automation
Automate your Ashby ATS recruiting operations directly from Claude Code. Create candidates, post jobs, manage applications, view interview schedules, and search your talent pipeline -- all without leaving your terminal.
Toolkit docs: composio.dev/toolkits/ashby
Setup
- Add the Rube MCP server to your Claude Code config with URL:
https://rube.app/mcp - When prompted, authenticate your Ashby account through the connection link provided
- Start automating your recruiting workflows with natural language
Core Workflows
1. Manage Candidates
Create, list, search, update, and retrieve detailed candidate information.
Tools: ASHBY_CREATE_CANDIDATE, ASHBY_LIST_CANDIDATES, ASHBY_SEARCH_CANDIDATES, ASHBY_GET_CANDIDATE_INFO, ASHBY_UPDATE_CANDIDATE
Create a candidate named "Jane Smith" with email jane@example.com and LinkedIn profile https://linkedin.com/in/janesmith
Key parameters for ASHBY_CREATE_CANDIDATE:
name(required) -- full name of the candidateemail-- primary email addressphoneNumber,linkedInUrl,githubUrl,websiteUrl-- contact/social profiles
Key parameters for ASHBY_SEARCH_CANDIDATES:
email-- exact email matchname-- partial name match
Key parameters for ASHBY_LIST_CANDIDATES:
perPage(max 100) /cursor-- paginationsyncToken-- for incremental updates since last sync
2. Create and List Jobs
Post new job openings and browse existing positions.
Tools: ASHBY_CREATE_JOB, ASHBY_LIST_JOBS, ASHBY_GET_JOB_INFO
Create a new "Senior Software Engineer" job in team dept-123 at location loc-456 with brand brand-789
Key parameters for ASHBY_CREATE_JOB:
title(required) -- job titleteamId(required) -- department/team ID (from list departments)locationId(required) -- office location ID (from list locations)brandId(required) -- employer brand ID (from list brands)defaultInterviewPlanId-- required to open the job for applicationsjobTemplateId-- pre-populate from a template
Key parameters for ASHBY_LIST_JOBS:
perPage(max 100) /cursor/syncToken-- pagination and incremental sync
Note: Newly created jobs start in "Draft" status. You must set a defaultInterviewPlanId to open/publish the job.
3. Manage Applications
Create applications to connect candidates to jobs and track their progress.
Tools: ASHBY_CREATE_APPLICATION, ASHBY_LIST_APPLICATIONS
Apply candidate cand-abc123 to job job-xyz789 with source src-referral
Key parameters for ASHBY_CREATE_APPLICATION:
candidateId(required) -- UUID of an existing candidatejobId(required) -- UUID of an existing jobsourceId-- UUID of the application source (LinkedIn, Referral, etc.)creditedToUserId-- UUID of recruiter/referrer to creditinterviewStageId-- place directly into a specific stage (defaults to first stage)
Key parameters for ASHBY_LIST_APPLICATIONS:
perPage(max 100) /cursor/syncToken-- pagination and incremental sync
4. View Interview Schedules
List scheduled interviews with timing, interviewer, and candidate details.
Tool: ASHBY_LIST_INTERVIEW_SCHEDULES
Show me all upcoming interview schedules
Key parameters:
perPage(max 100) /cursor-- paginationsyncToken-- incremental sync for changed schedules
5. Candidate Notes
View internal notes, observations, and recruiter comments on candidates.
Tool: ASHBY_LIST_CANDIDATE_NOTES
Show me all notes for candidate cand-abc123
- Retrieves all notes added by recruiters and hiring team members
- Useful for reviewing interview feedback and internal assessments
6. Pipeline Reporting
Combine listing tools to build hiring pipeline reports.
Tools: ASHBY_LIST_CANDIDATES, ASHBY_LIST_APPLICATIONS, ASHBY_LIST_JOBS
List all applications to see the current state of our hiring pipeline
- Use
syncTokenfor incremental data fetches (efficient for recurring reports) - Combine candidate, application, and job data for full pipeline visibility
- Paginate through all results with
cursorfor complete datasets
Known Pitfalls
- Jobs start in Draft: Newly created jobs via
ASHBY_CREATE_JOBstart in "Draft" status and cannot accept applications until adefaultInterviewPlanIdis set and the job is opened. - Four required fields for jobs:
ASHBY_CREATE_JOBrequirestitle,teamId,locationId, andbrandId. Use list departments, locations, and brands endpoints to discover valid IDs. - Candidate before application: A candidate must exist before creating an application. Always create or find the candidate first, then create the application.
- Cursor-based pagination: All list endpoints use cursor-based pagination with
perPage(max 100) andcursor. You cannot jump to arbitrary pages -- you must iterate sequentially. syncTokenfor efficiency: UsesyncTokenfrom previous responses to fetch only changed records. This dramatically reduces API calls for recurring workflows.- UUID format everywhere: All IDs (candidates, jobs, applications, stages) are UUIDs. Passing malformed IDs returns 400 errors.
- Search limitations:
ASHBY_SEARCH_CANDIDATESsupports exact email match or partial name match, but not combined queries or other fields. For broader searches, useASHBY_LIST_CANDIDATESwith pagination.
Quick Reference
| Tool Slug | Description |
|---|---|
ASHBY_CREATE_CANDIDATE |
Create a new candidate (requires name) |
ASHBY_LIST_CANDIDATES |
List all candidates with pagination and sync |
ASHBY_SEARCH_CANDIDATES |
Search candidates by email or name |
ASHBY_GET_CANDIDATE_INFO |
Get full candidate details (requires candidateId) |
ASHBY_UPDATE_CANDIDATE |
Update candidate profile information |
ASHBY_LIST_CANDIDATE_NOTES |
List internal notes for a candidate |
ASHBY_CREATE_JOB |
Create a job opening (requires title, teamId, locationId, brandId) |
ASHBY_LIST_JOBS |
List all jobs with pagination and sync |
ASHBY_GET_JOB_INFO |
Get full job details by ID |
ASHBY_CREATE_APPLICATION |
Apply a candidate to a job (requires candidateId, jobId) |
ASHBY_LIST_APPLICATIONS |
List all applications with pagination and sync |
ASHBY_LIST_INTERVIEW_SCHEDULES |
List scheduled interviews with pagination |
Powered by Composio
04 同仓库更多 Skills
x-article-draft-uploader
把本地 Markdown 转为经核验的 X Articles 新草稿。适用于需要保留首图封面、正文图片相对位置,并在独立 Playwright 会话中复用用户已授权 Chrome 登录态的任务;不负责公开发布。
wecom-operations
通过用户已配置的官方 wecom-cli 管理企业微信文档、智能文档、待办、会议和日程。适合创建或查询这些云端对象、把本地 Markdown 转为智能文档,以及在明确确认后更新或取消对象;不发送消息、不控制桌面客户端。
wecom-local-vault
Inspect authorized local WeCom databases on macOS, create private plaintext snapshots, and query or export contacts, conversations, and messages without modifying the source account store. Use when the user asks to parse 企业微信/WeCom local data, recover a private database snapshot, inspect local contacts or sessions, search chat history, or export a bounded conversation.
wechat-reading
Read and analyze WeRead/微信读书 search results, book metadata, bookshelf entries, progress, notes, highlights, public reviews, recommendations, and reading statistics through the official read-only Agent Gateway. Use for WeRead account questions or exports; do not imply that the current Gateway can add, remove, upload, rate, like, or edit content.
wechat-mp-batch-exporter
Build a bounded, private archive from known WeChat Official Account article URLs or an owner-authorized account-history export, with explicit reconciliation of article, publish-group, and platform-marked-original counts. Use for batch body capture, history normalization, or enhanced metrics/comments workflows. Do not use for a one-page summary or to automate the WeChat client.
wechat-local-vault
在 macOS 本机建立并查询私有微信数据快照。适用于盘点数据库、离线校验已有密钥候选、创建全量或增量明文快照、查会话与联系人、按时间检索消息、导出指定聊天、查看朋友圈或收藏,以及准备群聊摘要素材。所有查询只读,默认隐藏内部账号标识,不操控微信界面,也不发送任何内容。