> ## 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 from GitHub in ChatGPT, Codex, or Claude, connect your account, and start using its recruitment skills and MCP tools.

The HireData plugin combines reusable recruitment workflows with HireData's official MCP connection. It helps ChatGPT, Codex, and Claude understand how to plan, create, test, and improve HireData automations instead of giving them tools without the working method behind them.

<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. Use these steps with the ChatGPT desktop app, the Codex CLI, Claude Code, or a Claude Team/Enterprise organisation. 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 first release includes five skills:

* **Plan an activation** — connect client problems to high-impact HireData workflows and measurable outcomes.
* **Create triggers** — choose the right event, timing, filters, and relationships before creating a trigger.
* **Create forms** — design concise forms with validation, branching, and a clear next step.
* **Create email templates** — use variables, modifiers, and bounded AI variables safely.
* **Create WhatsApp templates** — design concise, contextual templates with appropriate category reasoning and follow-up paths.

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 | Five HireData skills and the MCP connection | You use ChatGPT desktop, Codex, or Claude and want both HireData knowledge and tools                                    |
| MCP only        | Live HireData tools without the five skills | You use Gemini, another MCP client, an individual Claude plan without an organisation catalog, or only need tool access |

## Before you begin

You need:

* A HireData account with access to at least one workspace.
* For ChatGPT or Codex: a current ChatGPT desktop app or Codex CLI with `codex plugin` support.
* For Claude: Claude Code, or a Claude Team/Enterprise organisation with Cowork and Skills enabled.
* Permission to add Git marketplaces and MCP connections. Your organisation's AI administrator may restrict these features.

## Install the plugin in ChatGPT or Codex

<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="Reload the plugin">
    Start a new Codex session. If you use the ChatGPT desktop app, restart it, open **Plugins**, and confirm that **HireData** appears under **Installed** or the **HireData Skills** marketplace.

    Installed skills and tools load when you start a new conversation. 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 try one of these requests in a new conversation:

    * "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."
  </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 Code

Run these commands inside Claude Code:

```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 (web, desktop, and Cowork)

An organisation Owner distributes the plugin through the organisation catalog:

<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 the plugin browser from the chat interface, install **HireData**, and complete the HireData sign-in on first use. 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>

Individual Claude plans without an organisation catalog can [install the skills with a prompt](#install-the-skills-with-a-prompt) and pair them with the [manual MCP connection](/apps/mcp/connect-hiredata-to-your-ai-assistant).

## Install the skills with a prompt

No plugin support on your plan or assistant? The skills are plain, public files, so you can let your AI assistant fetch and package them for you.

### Claude (chat, desktop, and Cowork)

Copy this prompt into a Claude conversation that can create files (for example a Cowork session):

```text theme={null}
Download the five HireData skills from https://github.com/HireData/skills
(they are in plugins/hiredata/skills). Package each skill as a separate
.skill file — a ZIP with that skill's SKILL.md and references folder at
its root — and send me the five files so I can save them as skills on my
account.
```

Save each file Claude delivers as a skill on your account. Combined with the [HireData MCP connector](/apps/mcp/connect-hiredata-to-your-ai-assistant), this gives you the same behaviour as the full plugin. If your organisation doesn't allow saving skills, ask an Owner to distribute the plugin through the organisation catalog instead.

### Any other assistant

Assistants without installable skills can still follow a skill for a single task. Replace the skill name and your goal in this prompt:

```text theme={null}
Fetch https://raw.githubusercontent.com/HireData/skills/main/plugins/hiredata/skills/hiredata-plan-activation/SKILL.md,
follow the workflow it describes (fetch the files it references too), and
help me with: [your goal]
```

This works in ChatGPT, Gemini, Microsoft Copilot, or any assistant that can read public web pages, and pairs well with the [manual MCP connection](/apps/mcp/connect-hiredata-to-your-ai-assistant). The five folder names are `hiredata-plan-activation`, `hiredata-create-triggers`, `hiredata-create-forms`, `hiredata-create-email-templates`, and `hiredata-create-whatsapp-templates`.

## Update the plugin

* **ChatGPT or Codex:** run `codex plugin marketplace upgrade hiredata-skills`, then open **Plugins** or run `/plugins` in Codex CLI to apply the update.
* **Claude Code:** run `/plugin marketplace update hiredata-skills`.
* **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.

## Troubleshooting

* **The `codex plugin` command is unavailable:** update Codex or the ChatGPT desktop app, then try again.
* **The HireData marketplace does not appear:** run `codex plugin marketplace list`, then restart the ChatGPT desktop app.
* **The plugin is installed but its skills do not appear:** enable HireData in **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 Codex administrator to allow the HireData marketplace and MCP connection.
* **The skills do not trigger in Claude:** confirm the plugin shows as installed (`/plugin` in Claude Code, or the plugin browser in a Claude organisation) 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 Codex:** run `codex plugin remove hiredata@hiredata-skills`.
* **Claude Code:** run `/plugin uninstall hiredata@hiredata-skills`.
* **Claude Team and Enterprise:** remove the plugin from the plugin browser, 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="View the source" icon="github" href="https://github.com/HireData/skills">
    Review the skills, installation metadata, eval cases, and contribution guide.
  </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 MCP: Connect HireData to your AI assistant](/apps/mcp/connect-hiredata-to-your-ai-assistant.md)