> ## Documentation Index
> Fetch the complete documentation index at: https://help.hiredata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the HireData plugin

> Install the HireData plugin in ChatGPT, Codex, or Claude to add every recruitment, diagnostic, and issue-reporting skill plus the MCP connection.

Installing the HireData plugin does two things in one step:

* It adds [HireData's skills](/apps/mcp/hiredata-skills) — the working method behind HireData's tools, covering activation planning, triggers, forms, email and WhatsApp templates, automation and email diagnostics, ROI reporting, staffing domain knowledge, and actionable Linear issues.
* It sets up HireData's official MCP connection, so your assistant can read and change things in the HireData workspaces you allow.

Nothing is installed inside HireData, and nothing changes in your workspaces until you ask for it. Prefer to skip the plugin? You can [install the skills with a prompt](/apps/mcp/install-hiredata-skills-with-a-prompt) instead.

<Note>
  The plugin is currently available as an early-access install from HireData's public GitHub marketplace. It does not appear in OpenAI's universal Plugins Directory yet. In every assistant you add HireData's marketplace first, then install the plugin from it. Use **Settings** > **Plugins** in the ChatGPT and Claude desktop apps, or the commands in the Codex CLI and Claude Code. For Gemini or an MCP-only connection, [connect HireData to your AI assistant](/apps/mcp/connect-hiredata-to-your-ai-assistant).
</Note>

## What the plugin adds

The plugin includes every skill HireData publishes — ten today. See [HireData skills for your AI assistant](/apps/mcp/hiredata-skills) for what each one does and example prompts:

* [**Plan an activation**](/apps/mcp/hiredata-skills#plan-an-activation) — connect client problems to high-impact HireData workflows and measurable outcomes.
* [**Create triggers**](/apps/mcp/hiredata-skills#create-triggers) — choose the right event, timing, filters, and relationships before creating a trigger.
* [**Create forms**](/apps/mcp/hiredata-skills#create-forms) — design concise forms with validation, branching, and a clear next step.
* [**Create email templates**](/apps/mcp/hiredata-skills#create-email-templates) — use variables, modifiers, and bounded AI variables safely.
* [**Create WhatsApp templates**](/apps/mcp/hiredata-skills#create-whatsapp-templates) — design concise, contextual templates with appropriate category reasoning and follow-up paths.
* [**Diagnose automations**](/apps/mcp/hiredata-skills#diagnose-automations) — find out why a workflow did not run, send, or finish as expected, and get a repair with its trade-off.
* [**Diagnose email performance**](/apps/mcp/hiredata-skills#diagnose-email-performance) — explain a drop in opens, clicks, or deliverability, and what to do about it.
* [**Report automation ROI**](/apps/mcp/hiredata-skills#report-automation-roi) — report what automations have actually delivered over the period they have genuinely been running.
* [**Write issue reports**](/apps/mcp/write-better-hiredata-issue-reports-with-ai) — draft and refine HireData Linear issues using the internal or partner workflow sources you can access.
* [**Apply staffing lifecycle knowledge**](/apps/mcp/hiredata-skills#apply-staffing-lifecycle-knowledge) — read recruitment requests correctly: a person, an application, and a placement are not the same thing.

The plugin also configures the existing remote HireData MCP connection at `https://api.hiredata.com/mcp`. It does not bundle or deploy a separate MCP server.

| Installation | What you get | Use it when |
| - | - | - |
| [HireData plugin](#install-the-plugin-in-chatgpt) | Every HireData skill and the MCP connection, updated from one button | You use ChatGPT desktop, Codex, or Claude and want both HireData knowledge and tools |
| [Skills with a prompt](/apps/mcp/install-hiredata-skills-with-a-prompt) | The skills you pick, saved by hand, and no automatic updates | Your assistant has no plugin support, or your organisation blocks the marketplace |
| [MCP only](/apps/mcp/connect-hiredata-to-your-ai-assistant) | Live HireData tools without the skills | You use Gemini, ChatGPT on the web, another MCP client, or only need tool access |

## Before you begin

You need:

* A HireData account with access to at least one workspace.
* For ChatGPT: the desktop app, or the Codex CLI with `codex plugin` support. ChatGPT on the web cannot install the plugin. See the note below.
* For Claude: the desktop app, Claude web, or Claude Code in a terminal.
* Permission to add Git marketplaces and MCP connections. Your organisation's AI administrator may restrict these features.

The `codex plugin` and `/plugin` commands below are CLI commands. They do not work in the ChatGPT or Claude desktop apps. Add the marketplace from **Settings** > **Plugins** in those apps instead.

## Install the plugin in ChatGPT

### ChatGPT desktop app

<Steps>
  <Step title="Add the HireData marketplace">
    Open **Settings** > **Plugins**, click **\[Add]**, then select **Add a marketplace**.

    <img src="https://mintcdn.com/hiredata/VDQ62WvYmo4gt0TN/images/chatgpt-plugins-add-marketplace.png?fit=max&auto=format&n=VDQ62WvYmo4gt0TN&q=85&s=531e6d85ee66228a0223f49775afc7e9" alt="The Add a marketplace option in ChatGPT's Plugins settings" width="1864" height="406" data-path="images/chatgpt-plugins-add-marketplace.png" />

    In **Add plugin marketplace**, enter `HireData/skills` in the **Source** field and click **\[Add marketplace]**. Leave **Git ref** and **Sparse paths** empty. Their greyed-out text is placeholder guidance, not a value you need to set. This adds HireData's public GitHub repository as a marketplace; you do not need to clone it.

    <img src="https://mintcdn.com/hiredata/VDQ62WvYmo4gt0TN/images/chatgpt-add-marketplace-source.png?fit=max&auto=format&n=VDQ62WvYmo4gt0TN&q=85&s=16c44193b2226a1f5861c2d1c15b355d" alt="HireData/skills entered in the Source field of ChatGPT's Add plugin marketplace dialog" width="1206" height="828" data-path="images/chatgpt-add-marketplace-source.png" />
  </Step>

  <Step title="Install HireData">
    **HireData** now appears under the **HireData Skills** marketplace. Click **\[Install]**.

    <img src="https://mintcdn.com/hiredata/VDQ62WvYmo4gt0TN/images/chatgpt-plugin-hiredata-install.png?fit=max&auto=format&n=VDQ62WvYmo4gt0TN&q=85&s=5170df64446b4da8b7ae1e910f46bd66" alt="The HireData plugin with its Install button under the HireData Skills marketplace in ChatGPT" width="846" height="352" data-path="images/chatgpt-plugin-hiredata-install.png" />
  </Step>

  <Step title="Connect your HireData account">
    Complete the sign-in flow when prompted. Select the workspace or workspaces the assistant may use, review the requested permissions, and click **\[Authorize]**.

    The assistant receives only the workspace access you select and works with your existing HireData permissions. See [how HireData access and security work](/apps/mcp/connect-hiredata-to-your-ai-assistant#how-access-and-security-work).
  </Step>

  <Step title="Start a new conversation">
    Installed skills and tools load when you start a new conversation. They do not appear retroactively in an existing one. Then [verify it works](#verify-it-works).
  </Step>
</Steps>

<Note>
  ChatGPT on the web cannot install the plugin: it cannot add a marketplace, and it does not show plugins you installed in the desktop app, so HireData will not appear there after a desktop install. Use the desktop app for the full plugin. On the web you can still upload skills from your computer, and [add HireData as a custom MCP server](/apps/mcp/connect-hiredata-to-your-ai-assistant) with Developer mode enabled.
</Note>

### Codex CLI

<Steps>
  <Step title="Add the HireData marketplace">
    Open a terminal and run:

    ```bash theme={null}
    codex plugin marketplace add HireData/skills
    ```

    This adds HireData's public GitHub repository as the `hiredata-skills` marketplace. You do not need to clone the repository.
  </Step>

  <Step title="Install HireData">
    Run:

    ```bash theme={null}
    codex plugin add hiredata@hiredata-skills
    ```

    Follow any setup prompt shown by Codex. The plugin source is public at [github.com/HireData/skills](https://github.com/HireData/skills).
  </Step>

  <Step title="Start a new session">
    Installed skills and tools load when you start a new Codex session. They do not appear retroactively in an existing one.
  </Step>

  <Step title="Connect your HireData account">
    When prompted, sign in to HireData. Select the workspace or workspaces the assistant may use, review the requested permissions, and click **Authorize**.

    The assistant receives only the workspace access you select and works with your existing HireData permissions. See [how HireData access and security work](/apps/mcp/connect-hiredata-to-your-ai-assistant#how-access-and-security-work).
  </Step>

  <Step title="Verify the installation">
    Check the installed plugin from the terminal:

    ```bash theme={null}
    codex plugin list --marketplace hiredata-skills
    ```

    Then [verify it works](#verify-it-works) in a new session.
  </Step>
</Steps>

## Install the plugin in Claude

Installing the plugin also configures the HireData MCP connection, so you don't need to set up a separate connector.

### Claude desktop app and web

<Steps>
  <Step title="Add the HireData marketplace">
    Open **Settings** > **Plugins**, click **\[Add]**, then select **Add marketplace**. On a personal Claude plan, Claude first asks where to add from. Select **Add from a repository** rather than **Browse Anthropic sources**.

    <img src="https://mintcdn.com/hiredata/VDQ62WvYmo4gt0TN/images/claude-plugins-add-marketplace.png?fit=max&auto=format&n=VDQ62WvYmo4gt0TN&q=85&s=4bbfbc604ac14491d0be7931203dc4df" alt="The Add marketplace option in Claude's Plugins settings" width="1412" height="308" data-path="images/claude-plugins-add-marketplace.png" />

    Type `HireData/skills` into the **URL** field, then click **Use "HireData/skills"** or press Enter. This adds HireData's public GitHub repository as a marketplace; you do not need to clone it.

    Claude shows a warning that marketplace plugins are not controlled or verified by Anthropic. HireData publishes this plugin, and its source is public at [github.com/HireData/skills](https://github.com/HireData/skills).

    <img src="https://mintcdn.com/hiredata/VDQ62WvYmo4gt0TN/images/claude-add-marketplace-url.png?fit=max&auto=format&n=VDQ62WvYmo4gt0TN&q=85&s=f83a13c86348020f395e4baef1e44827" alt="HireData/skills typed into the URL field of Claude's Add marketplace dialog" width="1466" height="716" data-path="images/claude-add-marketplace-url.png" />
  </Step>

  <Step title="Install HireData">
    **HireData** appears under the **skills** marketplace on the **Personal** tab. Click the **\[+]** on its card, or open the card and click **\[Install]**.

    <img src="https://mintcdn.com/hiredata/VDQ62WvYmo4gt0TN/images/claude-plugin-hiredata-install.png?fit=max&auto=format&n=VDQ62WvYmo4gt0TN&q=85&s=2dac031c00ff7ede7b3fb8bf3274ab19" alt="The HireData plugin card with its plus button under the skills marketplace in Claude" width="832" height="452" data-path="images/claude-plugin-hiredata-install.png" />
  </Step>

  <Step title="Connect your HireData account">
    Sign in to HireData when prompted on first use. Select the workspace or workspaces Claude may use, review the requested permissions, and click **\[Authorize]**.

    Claude receives only the workspace access you select and works with your existing HireData permissions. See [how HireData access and security work](/apps/mcp/connect-hiredata-to-your-ai-assistant#how-access-and-security-work).
  </Step>

  <Step title="Start a new conversation">
    Installed skills and tools load when you start a new conversation. They do not appear retroactively in an existing one. Then [verify it works](#verify-it-works).
  </Step>
</Steps>

### Claude Code

The `/plugin` commands work in Claude Code in a terminal. Run:

```bash theme={null}
/plugin marketplace add HireData/skills
/plugin install hiredata@hiredata-skills
```

Sign in to HireData when prompted on first use, select the allowed workspaces, and authorize. Start a new conversation before testing. Skills are namespaced as `/hiredata:hiredata-plan-activation` and so on.

### Claude Team and Enterprise

Owners can distribute the plugin through the organisation catalog instead of having each member add the marketplace:

<Steps>
  <Step title="Add the marketplace">
    Open **Organization settings** > **Plugins** and add a GitHub-synced marketplace with the repository `HireData/skills`. The initial sync runs automatically, and later plugin releases sync from the repository's default branch.

    Alternatively, add a custom marketplace and upload the plugin as a ZIP file (the `plugins/hiredata` directory from the repository). Use this when your organisation prefers not to sync from GitHub; note that manual uploads do not receive automatic updates.
  </Step>

  <Step title="Make the plugin available">
    Set the HireData plugin's installation preference, for example **Available for install** or **Installed by default**.
  </Step>

  <Step title="Install as a member">
    Members open **Settings** > **Plugins**, install **HireData**, and complete the HireData sign-in on first use. They do not need to add the marketplace themselves. The plugin then works in Claude web chat, the Claude desktop app, and Cowork sessions. If the Owner set the plugin to **Installed by default**, members skip this step entirely.
  </Step>
</Steps>

## Verify it works

Start a new conversation and try one of these requests:

* "Use HireData to review our existing templates and rank the highest-impact missing workflow. Do not create anything yet."
* "Use HireData to design an application acknowledgement email that uses an AI variable safely. Show me a preview and do not send it."
* "Use HireData to create a candidate availability form. Show me the form and branching logic before creating it."
* "Use HireData to turn these reproduction steps and screenshots into an issue report. Draft only."

If your assistant asks you to sign in to HireData at this point, that is expected. The connection authorizes on first use.

## Install the skills with a prompt

Can't install the plugin — no plugin support on your plan, or your organisation blocks the marketplace? The skills are plain, public files, so your assistant can fetch and package them for you instead, and you save them yourself.

[Install the HireData skills with a prompt](/apps/mcp/install-hiredata-skills-with-a-prompt) has the copy-paste prompt for Claude, ChatGPT, and any other assistant, plus the full list of skill folder names. Pair it with the [HireData MCP connection](/apps/mcp/connect-hiredata-to-your-ai-assistant) to get the same behaviour as the full plugin.

## Update the plugin

* **ChatGPT or Claude desktop app:** update the plugin from **Settings** > **Plugins**.
* **Codex CLI:** run `codex plugin marketplace upgrade hiredata-skills`, then run `/plugins` to apply the update.
* **Claude Code:** run `/plugin marketplace update hiredata-skills` in a terminal.
* **Claude Team and Enterprise:** GitHub-synced marketplaces update automatically when HireData publishes a new plugin version. Manually uploaded ZIPs require a new upload.

Start a new conversation after updating so your assistant loads the new skills and configuration.

HireData adds and improves skills over time. [Keep your HireData skills up to date](/apps/mcp/keep-hiredata-skills-up-to-date) shows how to check which version you have, and how to be told when something new arrives instead of remembering to look.

## Troubleshooting

* **A `/plugin` or `codex plugin` command does nothing:** these are CLI commands, and only work in Claude Code and the Codex CLI. In the ChatGPT and Claude desktop apps, add the marketplace from **Settings** > **Plugins**.
* **HireData does not appear in ChatGPT on the web after a desktop install:** the web app cannot add marketplaces and does not show plugins installed in the desktop app. Use the desktop app, or [add HireData as a custom MCP server](/apps/mcp/connect-hiredata-to-your-ai-assistant) on the web for tools without the skills.
* **The `codex plugin` command is unavailable:** update the Codex CLI, then try again.
* **The HireData marketplace does not appear in the Codex CLI:** run `codex plugin marketplace list`, then start a new session.
* **The plugin is installed but its skills do not appear:** enable HireData in **Settings** > **Plugins** and start a new conversation.
* **HireData does not ask you to sign in:** start a new conversation with the plugin enabled and make a request that needs HireData workspace data.
* **Your organisation blocks the installation:** ask your ChatGPT or Claude administrator to allow the HireData marketplace and MCP connection.
* **The skills do not trigger in Claude:** confirm the plugin shows as installed (**Settings** > **Plugins**, or `/plugin` in Claude Code) and start a new conversation.
* **You only need the MCP tools or use another assistant:** follow the [manual MCP connection guide](/apps/mcp/connect-hiredata-to-your-ai-assistant).

## Remove the plugin

* **ChatGPT or Claude desktop app:** remove the plugin from **Settings** > **Plugins**.
* **Codex CLI:** run `codex plugin remove hiredata@hiredata-skills`.
* **Claude Code:** run `/plugin uninstall hiredata@hiredata-skills` in a terminal.
* **Claude Team and Enterprise:** remove the plugin from **Settings** > **Plugins**, or ask an Owner to change its availability in **Organization settings** > **Plugins**. Plugins marked **Required** by an Owner cannot be removed by members.

Removing the plugin does not necessarily revoke an existing HireData OAuth grant. Disconnect HireData in your AI assistant or revoke the grant in HireData settings when you also want to remove access.

<CardGroup cols={2}>
  <Card title="Install skills with a prompt" icon="wand-magic-sparkles" href="/apps/mcp/install-hiredata-skills-with-a-prompt">
    No plugin support, or a blocked marketplace? Let your assistant fetch the skills instead.
  </Card>

  <Card title="Keep skills up to date" icon="arrows-rotate" href="/apps/mcp/keep-hiredata-skills-up-to-date">
    Check your version, update in one step, and get told when new skills arrive.
  </Card>

  <Card title="Create your own skill" icon="hammer" href="/apps/mcp/create-your-own-skill">
    Capture your own method once, and contribute it back to the skills repository.
  </Card>

  <Card title="Connect via MCP only" icon="plug" href="/apps/mcp/connect-hiredata-to-your-ai-assistant">
    Connect Gemini, or any MCP-compatible assistant, without installing the skills.
  </Card>
</CardGroup>


## Related topics

- [HireData skills for your AI assistant](/apps/mcp/hiredata-skills.md)
- [Install the HireData skills with a prompt](/apps/mcp/install-hiredata-skills-with-a-prompt.md)
- [Keep your HireData skills up to date](/apps/mcp/keep-hiredata-skills-up-to-date.md)
- [HireData MCP: Connect HireData to your AI assistant](/apps/mcp/connect-hiredata-to-your-ai-assistant.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.