# Homerun MCP by usefulapi

> Homerun MCP by usefulapi is an MCP server. Read Homerun vacancies, applications, notes and tags; move an application to a stage or add a note. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/homerun/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/homerun
- **MCP Registry name:** io.usefulapi/homerun
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://homerun.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "homerun": {
      "serverUrl": "https://homerun.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `homerun_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).
- `homerun_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).
- `homerun_list_applications`: 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 i
- `homerun_get_application`: 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/{j
- `homerun_list_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).
- `homerun_list_tags`: List the company's candidate tags (id + name). GET /tags (scope tags:read).
- `homerun_list_application_tags`: The tags attached to one application. GET /job-applications/{job_application_id}/tags (scope job-application-tags:read).
- `homerun_move_application_to_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} 
- `homerun_add_note`: 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).

## FAQ

### How do I add Homerun MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http homerun https://homerun.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/homerun-mcp-by-usefulapi
