MCP server

Homerun MCP by usefulapi

io.usefulapi/homerun

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Read Homerun vacancies, applications, notes and tags; move an application to a stage or add a note.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

9

Token cost

About 2,294 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http homerun https://homerun.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.homerun]
url = "https://homerun.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"homerun":{"httpUrl":"https://homerun.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"homerun":{"url":"https://homerun.usefulapi.io/mcp"}}}

VS Code

{"servers":{"homerun":{"type":"http","url":"https://homerun.usefulapi.io/mcp"}}}

Antigravity

agy mcp add homerun https://homerun.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"homerun","server_url":"https://homerun.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"homerun","server_url":"https://homerun.usefulapi.io/mcp"}

Tools

• homerun_add_note ~278 tokens
  WRITE: add ONE note (1-2000 characters) to one application. It becomes visible to the hiring team in Homerun and cannot be removed with this server. display_name is free text shown as the author. Nothing is sent to the candidate. POST /job-applications/{job_application_id}/notes (scope job-applicati
• homerun_get_application ~257 tokens
  One job application in full: contact details (name, e-mail, phone, city, country), links, experience/education, current stage, rating, sources and file names (notes: use homerun_list_notes). Date of birth, photo URL and file download links are never returned. Optionally include the answers to the ap
• homerun_get_vacancy ~149 tokens
  One vacancy by id with description, location, department, hiring stages (id + name), salary indication, candidate count and the public job and application-form URLs. GET /vacancies/{vacancy_id} (scope vacancies:read).
• homerun_list_application_tags ~197 tokens
  The tags attached to one application. GET /job-applications/{job_application_id}/tags (scope job-application-tags:read).
• homerun_list_applications ~479 tokens
  List job applications, newest page first as the API orders them. Each item has name, e-mail, vacancy id, current stage (id + name), rating, created/hired dates and disqualified flag. Personal data: no phone number, date of birth, photo or files are returned here; ask for one application with homerun
• homerun_list_notes ~212 tokens
  List the notes on one application: id, author display name, text, sensitive flag and timestamps. GET /job-applications/{job_application_id}/notes (scope job-application-notes:read).
• homerun_list_tags ~141 tokens
  List the company's candidate tags (id + name). GET /tags (scope tags:read).
• homerun_list_vacancies ~326 tokens
  List job vacancies (draft, private, public, ...) with title, status, type, location type and expiry. Optionally include location, department, hiring stages (their ids are what homerun_move_application_to_stage needs), salary indication and the candidate count. GET /vacancies (scope vacancies:read).
• homerun_move_application_to_stage ~255 tokens
  WRITE: move ONE application to another hiring stage of its vacancy (PATCH with only the stage id; nothing else on the application changes). Get stage ids from homerun_get_vacancy. Homerun's own automations for that stage may run (for example automatic e-mails configured in Homerun); this tool sends

Browse

• Email
• Hiring and jobs

Related MCP servers

• 100Hires - AI ATS & Recruitment Software
  Official 100Hires MCP: AI ATS & Recruitment Software for candidates, jobs, applications, interviews.
• Pipeline CRM MCP by usefulapi
  Manage Pipeline CRM deals, people, companies, notes and calendar entries.
• Propstack MCP by usefulapi
  Read Propstack contacts, properties, projects, deals, tasks, events; create and update CRM records.
• Recruitee MCP by usefulapi
  Search Recruitee candidates, jobs, pipelines and interviews, and add notes, tags and tasks.
• Freshsales MCP by usefulapi
  Manage Freshsales contacts, accounts, deals, tasks and appointments; add notes.
• Keywordise
  Auto-apply to jobs: matches your CV, tailors a fresh CV per posting, and applies for you.
• Datronis
  Search and apply to real jobs, browse companies, and read tech news via Datronis's live data.
• CentralStationCRM MCP by usefulapi
  Read CentralStationCRM people, companies, deals, tasks; create and update people, companies, deals.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/homerun.svg)](https://aptlynx.net/servers/io.usefulapi/homerun)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents