Homerun MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.23.5Updated Nov 8, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

Homerun MCP by usefulapi's hosted MCP server (homerun.usefulapi.io), published by usefulapi.io; no sign-in required; Streamable HTTP; 9 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Publisher
usefulapi.io
Endpoint
homerun.usefulapi.io
Last checked

Installation

In SourceWeft

  1. Open Homerun MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fhomerun/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "homerun-by-usefulapi": {
      "type": "http",
      "url": "https://homerun.usefulapi.io/mcp"
    }
  }
}

README

Homerun MCP by usefulapi

Use Homerun from Claude, Cursor, or any MCP client — vacancies, job applications, notes and tags, plus single-application stage moves and notes. Hosted, no local install: connect with your own Homerun credentials.

Live endpoint: https://homerun.usefulapi.io/mcp · Homepage: https://usefulapi.io/homerun

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://homerun.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http homerun https://homerun.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "homerun": {      "url": "https://homerun.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Homerun credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/homerun/

Tools

ToolTypeWhat it does
homerun_list_vacanciesreadList vacancies
homerun_get_vacancyreadGet vacancy
homerun_list_applicationsreadList applications (candidates)
homerun_get_applicationreadGet application (candidate)
homerun_list_notesreadList application notes
homerun_list_tagsreadList tags
homerun_list_application_tagsreadList an application's tags
homerun_move_application_to_stagewriteMove application to a stage
homerun_add_notewriteAdd a note to an application
homerun_usage_statusmetaUsage status (free-tier meter)
homerun_request_featuremetaRequest a missing feature
homerun_upgrademetaUpgrade to Pro or Pro+
homerun_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with homerun_upgrade (it returns a Stripe Checkout link). Cancel any time with homerun_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running homerun_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Homerun.

Source: servers/homerun/README.md at commit 4046075

Tools

9

homerun_list_vacancies

List vacancies

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).

ParameterspagestatusincludeperPage

homerun_get_vacancy

Get vacancy

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).

Parametersvacancy_idrequired

homerun_list_applications

List applications (candidates)

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_get_application. Filter by vacancy, stage name or disqualified state and page through; do not use it to export all candidates. GET /job-applications (scope job-applications:read).

ParameterspagestageperPagevacancy_idhired_afterdisqualifiedinclude_sources

homerun_get_application

Get application (candidate)

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 application-form questions. Personal data: fetch only the candidate you need. GET /job-applications/{job_application_id} (scope job-applications:read).

Parametersinclude_answersjob_application_idrequired

homerun_list_notes

List application notes

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).

ParameterspageperPagejob_application_idrequired

homerun_list_tags

List tags

List the company's candidate tags (id + name). GET /tags (scope tags:read).

ParameterspageperPage

homerun_list_application_tags

List an application's tags

The tags attached to one application. GET /job-applications/{job_application_id}/tags (scope job-application-tags:read).

ParameterspageperPagejob_application_idrequired

homerun_move_application_to_stage

Move application to a stage

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 no e-mail itself and does not reject or delete anyone. PATCH /job-applications/{job_application_id} (scope job-applications:write).

Parametersstage_idrequiredjob_application_idrequired

homerun_add_note

Add a note to an application

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-application-notes:write).

Parametersnoterequireddisplay_nameis_sensitivejob_application_idrequired

Version history

20
  1. v1.23.5LatestNov 8, 2026
  2. v1.23.4Nov 7, 2026
  3. v1.22.3Nov 5, 2026
  4. v1.22.2Nov 5, 2026
  5. v1.22.1Nov 4, 2026
  6. v1.22.0Nov 3, 2026
  7. v1.21.1Nov 3, 2026
  8. v1.20.0Nov 1, 2026
  9. v1.18.0Oct 31, 2026
  10. v1.17.0Oct 31, 2026
  11. v1.16.2Oct 30, 2026
  12. v1.16.0Oct 30, 2026
  13. v1.11.0Oct 26, 2026
  14. v1.8.3Oct 25, 2026
  15. v1.8.0Oct 25, 2026
  16. v1.7.0Oct 24, 2026
  17. v1.4.0Oct 23, 2026
  18. v1.3.4Oct 22, 2026
  19. v1.3.3Oct 21, 2026
  20. v1.0.0Oct 12, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations