Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api-docs.spott.io/llms.txt

Use this file to discover all available pages before exploring further.

The Spott connector for Claude lets recruiters work in Spott directly from a Claude conversation. Claude can search your candidates, jobs, and companies, move applications through your pipeline, schedule interviews, log calls and notes, send emails, parse CVs, and close placements — all scoped to the authenticated user’s tenant and reflected back in the Spott UI in real time.
The connector exposes tools only — there is no separate Spott workspace inside Claude. Every action runs against your live Spott account, and respects the same permissions you have in the Spott UI.

​
Prerequisites

  • An active Spott workspace with a paid subscription
  • A Spott user account with the permissions you’d normally use in the Spott UI
  • A Claude account on any plan (Free, Pro, Max, Team, or Enterprise)

​
Connect Spott to Claude

1

Open the Connectors menu

In Claude.ai, click the + button at the bottom-left of the chat, then choose Connectors.
2

Find Spott

Browse or search for Spott in the directory.
3

Connect

Click Connect. You’ll be redirected to app.spott.io to sign in with your Spott credentials.
4

Authorize

Review the requested permissions and click Allow. You’ll be redirected back to Claude.
5

Enable for your conversation

Click + → Connectors in your chat and toggle Spott on for this conversation.
If Spott isn’t yet listed in the directory for your client, you can add it as a custom connector with the URL https://mcp.spott.io/mcp. Custom connector availability and limits differ by Claude plan.

​
What you can do

You can use the Spott connector to:

Search candidates, jobs & companies

“Find Python engineers in Brussels with 5+ years of experience”

Manage applications & pipeline

“Move Emma to the offer stage and email her the offer letter”

Schedule interviews

“Book a 30-minute intro between Mario and Dimitri from Forum Jobs tomorrow at 2pm”

Log calls, notes & activity

“Log a call with John yesterday — 3 month notice, €85k, available next week”

Parse CVs & enrich candidates

“Create a candidate from this CV and enrich their email and LinkedIn”

Place candidates & close deals

“Place Sarah at Google as Senior PM, start date Feb 1, 25% fee”

​
Permissions and data scope

The Spott connector respects every permission and role configured in your Spott workspace. Claude can only see and modify records you have access to in the Spott UI.
  • Tenant isolation: Each user authenticates with their own Spott credentials. Claude never sees data outside your tenant.
  • Read and write: The connector includes both read tools (search, lookup, activity) and write tools (create, update, send). Write tools with external side effects (sending emails, scheduling interviews, placing candidates) are flagged so Claude treats them with extra care.
  • Confirmation for high-impact actions: Claude will confirm with you before sending external communications or making irreversible changes like placing a candidate or rejecting an application.

​
Troubleshooting

Disconnect and reconnect Spott from Claude → Settings → Connectors. Clear cookies for app.spott.io if the issue persists. If your workspace uses SSO, make sure your identity provider session is active before connecting.
Make sure the Spott connector is enabled for the current conversation (+ → Connectors). If you have many connectors active, switch tool access mode to On demand to give Claude more room to surface Spott reliably.
The Spott MCP enforces the same permissions as the Spott UI. If you can’t see a record in Spott itself, Claude can’t either. Ask your workspace admin to grant the required role.
spott_schedule_interview schedules an interview against an existing application. If the candidate doesn’t have an application on the relevant job yet, create the application first (for example: “Add Mario as an applicant on the Forum Jobs Senior Backend role”) and try again.
spott_place_candidate advances an existing application to the placed stage. The candidate must already be on a job’s pipeline. If they aren’t, create the application first.

​
Privacy and security

  • Spott is hosted in the EU and is GDPR-compliant.
  • Customer data is never used to train AI models.
  • All data is encrypted in transit (TLS) and at rest.
  • A Data Processing Agreement (DPA) is available on request.
For full details, see the Spott Privacy Policy.

​
Support

Email support

support@spott.io

Spott documentation

docs.spott.io
For Claude-specific connector questions, see Anthropic’s connectors help.