# Gem MCP

> Gem connects your recruiting CRM to any AI agent, letting you manage the full talent pipeline directly through conversation. It lets recruiters track candidates, log notes, build out project details, and handle outreach sequences without ever leaving their chat interface. Use this MCP to automate candidate sourcing and relationship management.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** talent-sourcing, candidate-tracking, recruiting-crm, hiring-pipeline, outreach-automation

## Description

Forget switching between dashboards just to check a status update. This MCP connects your Gem recruitment CRM to any AI agent, letting you manage the entire talent pipeline through natural conversation. You can tell your agent to list every active candidate in your database or pull detailed records on a specific person's history. Need to add someone new? Your agent handles that, too. It’s built to handle the messy reality of recruiting—where details are scattered across notes, projects, and outreach lists. When you subscribe through Vinkius Marketplace, you get immediate access to this power from any compatible client. You can ask your AI agent to compile a report on all candidates who passed their technical screening last month, or programmatically log an interview note right after the call ends. This makes sure your data is always current and accessible, whether you're in Slack or writing code.

## Tools

### verify_api_connection
Checks if the connection to the Gem CRM is working correctly.

### create_crm_candidate
Adds a brand new candidate record into your CRM system.

### add_candidate_note
Logs a new interaction or note against an existing candidate's profile.

### get_candidate_details
Retrieves all the metadata and information stored for a specific candidate.

### list_crm_custom_fields
Lists all custom data fields set up by your team in the CRM.

### get_project_details
Fetches detailed information and metadata about a specific talent project.

### list_candidates
Lists all candidates currently in your CRM pipeline.

### list_candidate_notes
Retrieves a list of historical notes and interactions for a candidate.

### list_talent_projects
Lists all the talent sourcing projects tracked in Gem.

### list_outreach_sequences
Shows you all the active automated messaging or outreach campaigns currently running.

### list_recruiting_team
Lists all team members and recruiters associated with your account.

### update_crm_candidate
Modifies specific details or information on an existing candidate record.

## Prompt Examples

**Prompt:** 
```
List all active candidates in my Gem CRM.
```

**Response:** 
```
Retrieving candidates... I found 5 active profiles, including 'John Doe' (Full Stack Engineer) and 'Jane Smith' (Product Manager). Would you like to see the interaction notes for any of them?
```

**Prompt:** 
```
Show me the interactions history for candidate '12345'.
```

**Response:** 
```
Fetching notes... For candidate 12345, I found 3 recent interactions. Last update was from Recruiter Sarah: 'Candidate passed the technical screening and is moving to onsite'.
```

**Prompt:** 
```
Create a new candidate record for 'Alice Smith' (alice@email.com).
```

**Response:** 
```
Candidate created! I have successfully added 'Alice Smith' (alice@email.com) to your Gem CRM. The new Candidate ID is 98765.
```

## Capabilities

### List active candidate records
Get a list of all candidates currently stored in the CRM.

### Retrieve detailed candidate profiles
Fetch comprehensive metadata and historical information for any single candidate.

### Add or update candidate records
Create new candidates or modify the details of existing profiles in the CRM.

### Log interaction notes
Record a specific note, such as an interview summary or follow-up action, against a candidate's file.

### Review project status and metadata
Examine details about your ongoing talent sourcing projects.

### Manage outreach campaigns
List active automated messaging sequences and engagement efforts.

## Use Cases

### Need to onboard an urgent candidate?
A recruiter finds a perfect profile but it’s not in the CRM. Instead of manually creating a record, they ask their agent to `create_crm_candidate` for the person, instantly adding them and getting a new ID for follow-up.

### Reviewing a candidate's background before a call?
A hiring manager needs to know everything about 'John Smith'. They ask their agent to `get_candidate_details` and then `list_candidate_notes`, getting a summarized view of all interactions, not just the latest entry.

### What projects are stalled?
A Talent Ops specialist wants an overview of current sourcing efforts. They ask their agent to `list_talent_projects` and then use `get_project_details` on a specific project to see the latest activity.

### Updating contact info quickly?
A recruiter finds an email typo in a candidate's record. They simply prompt their agent to `update_crm_candidate` with the corrected information, avoiding manual navigation and risking human error.

## Benefits

- Get instant insights by running `list_candidates` through your agent. Instead of clicking filters to see who's active, you just ask for the list, saving minutes every single day.
- Stop losing context. Use `add_candidate_note` right after a call ends. The notes are logged instantly and tied directly to the candidate record using simple conversation prompts.
- Track your pipeline health by calling `list_talent_projects`. You get an immediate summary of project status without having to navigate the full dashboard structure.
- Ensure data accuracy across teams. Use `list_crm_custom_fields` to verify exactly what types of information are being tracked, which is huge for Talent Ops.
- Stay updated on outreach efforts by listing active sequences using `list_outreach_sequences`. You immediately know if a campaign stalled or needs attention.

## How It Works

The bottom line is that you get a single conversation point to manage complex CRM functions normally requiring multiple clicks and dashboard navigations.

1. Subscribe to this MCP via the Vinkius Marketplace.
2. Enter your Gem API Key into your AI client settings.
3. Tell your agent what you need—for example, 'List all candidates who are Product Managers'—and it handles the rest.

## Frequently Asked Questions

**How do I use Gem MCP to add a new candidate?**
You simply ask your agent to 'Create a new candidate record' and provide the required details. The tool handles the API call using `create_crm_candidate`, adding them directly to your CRM.

**Can Gem MCP help me track project progress?**
Yes, you can use `list_talent_projects` to see all active projects. Then, running `get_project_details` gives you the specific metadata needed to understand how far along a sourcing effort is.

**What if I need to update a candidate's record?**
Use the `update_crm_candidate` tool. You just tell your agent what field needs changing and with what value, making modifications quick and reliable from chat.

**Is Gem MCP better than manually logging notes?**
Absolutely. Using `add_candidate_note` ensures that the note is properly typed to a specific candidate ID within the CRM's structured history, preventing data silos and missed context.

**Does Gem MCP list all team members?**
Yes, you can call `list_recruiting_team` to get a roster of every user in your account. This is useful for verifying ownership or assigning tasks within the CRM.