PeopleHR MCP Server
Approve holiday requests, assign tasks and run saved queries in PeopleHR.
Размещённый MCP-сервер
npx add-mcp 'https://cotlet.dev/mcp/v1/peoplehr'Устанавливается в Claude Code, Codex, Cursor и другие
Документация
Cotlet · All integrations · MCP servers · APIs · API & MCP status · How it works · Security · Custom API · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up
PeopleHR MCP server · unofficial, by Cotlet Let your AI agent work in your PeopleHR account.
Cotlet is a cloud browser that stays signed in to your PeopleHR business account, so ChatGPT, Claude or any AI agent can work in it. Free 7-day trial, no card.
Source: https://cotlet.dev/integrations/peoplehr-api-mcp-server
Cotlet is a cloud browser with a remote MCP server. It stays signed in to your PeopleHR business account, so ChatGPT, Claude or any MCP client can work on the same screens you use: employees, holiday requests, absence and tasks.
- Free 7-day trial, no card
- Unofficial, not affiliated with PeopleHR
Server URL
https://cotlet.dev/mcp/v1
Connection
Streamable HTTP · OAuth or API key
Works in
ChatGPT, Claude, Claude Code, Cursor, Codex, n8n
PeopleHR facts on this page were checked on 20 Nov 2026.
Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by PeopleHR. PeopleHR is a trademark of its owner. If PeopleHR's own integrations cover what you need, use them first.
Six HR jobs
What can you ask your agent to do in PeopleHR? Whatever your own login can do by hand.
-
Approve next week's holiday requests that keep two people on the support team.
-
Who is off next week, and does anyone overlap on the support team?
-
Leo starts on Monday. Give his manager the new starter tasks.
-
Change Ana R.'s job title to Finance Lead from December 1.
-
Run my saved absence query for this quarter.
-
Whose probation ends this month?
Remote MCP server
How does the PeopleHR MCP server from Cotlet work?
Cotlet runs a remote MCP server that gives your AI agent a Cloud Browser: a Chrome that runs in the cloud and stays signed in to your PeopleHR business account. Your AI client connects to the server and gets browser tools from it. Before its first step in PeopleHR, the agent reads Cotlet's guide to PeopleHR's screens. Then it opens www.peoplehr.com in your Cloud Browser and works on the same screens you use.
- YOUR AI ChatGPT, Claude, Cursor, n8n or any MCP client
- COTLET MCP SERVER https://cotlet.dev/mcp/v1 Streamable HTTP · OAuth or API key
- YOUR CLOUD BROWSER Chrome in the cloud, signed in as you
- PEOPLEHR www.peoplehr.com
PeopleHR MCP server from Cotlet
| What | Answer |
|---|---|
| Server URL with OAuth sign-in | https://cotlet.dev/mcp/v1/connect for ChatGPT, Claude, Claude Code and Grok |
| Server URL with an API key | https://cotlet.dev/mcp/v1 for Codex, Cursor, Hermes Agent, n8n and other MCP clients |
| Transport | Streamable HTTP |
| Tools your agent gets | Browser tools to open, read, click, type, select, fill in forms, scroll, take screenshots and download files, plus a guide to PeopleHR's screens |
| Where PeopleHR runs | Your Cloud Browser, signed in with your own PeopleHR login |
| What Cotlet stores | The signed-in session, encrypted. No password |
| Status | Unofficial. Cotlet is not affiliated with PeopleHR |
Claude Code
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1/connect
The same server and the same tools work in any web app you sign in to. PeopleHR is one of them.
Set up once
How to connect PeopleHR to your AI agent Three steps, no code.
You need the owner login of your PeopleHR business account (or a team login with the access you want the agent to have), a PeopleHR login with the HR or manager rights you want the agent to use, and a Cotlet account. The free trial gives you 2,000 credits for 7 days, no card.
- Step 1
Sign in to PeopleHR
Your business account, in your Cloud Browser. 2. Step 2
Connect your AI agent
Add the Cotlet server to ChatGPT, Claude or another client. 3. Step 3
Ask for a first job
Your agent asks before it approves, changes or assigns.
We never see your PeopleHR password, and holiday decisions, record changes and new tasks wait for your OK. Who can see your session
On this page
Any MCP client
Connect PeopleHR to your AI agent
Step 1: sign in to PeopleHR in your Cloud Browser
In the Cotlet console, open your Cloud Browser, go to www.peoplehr.com and sign in with your usual email and password. If PeopleHR asks for a code, you enter it there yourself.
You type the password into PeopleHR's own page. Cotlet does not see it and does not store it; it keeps only the signed-in session, encrypted. If PeopleHR signs you out one day, your agent says so and sends you a link to sign in again.
Step 2: connect your AI agent
Pick the AI you already use. ChatGPT, Claude, Claude Code, Codex, Cursor, Grok, Hermes Agent, n8n and other MCP clients all work in the same signed-in PeopleHR account.
ChatGPTchatgpt.com and its apps Claudeclaude.ai and desktop app Claude Codeone terminal command Codexone entry in config.toml Cursorone entry in mcp.json Grokgrok.com connectors Hermes Agentone block in config.yaml n8nMCP Client node Any MCP clientOpenClaw and others
Pick your AI above to see its steps.
How to connect PeopleHR to ChatGPT
Do this on chatgpt.com in your browser. Cotlet then works in the ChatGPT desktop and phone apps too.
- Open Plugins in ChatGPT and click Add.
- Click Add custom MCP server. Not in the menu? Turn on Developer mode in Settings, Security and login, then come back.
- Paste the name
Cotletand the server URLhttps://cotlet.dev/mcp/v1/connect. Keep Authentication on OAuth. - Tick "I understand and want to continue" and click Create as a plugin.
- Click Connect Cotlet. A Cotlet page opens, click Allow access.
- In a new chat, type
@Cotletand pick it from the list. - Ask ChatGPT: "Are you signed in to Cotlet through MCP?" Then try a first PeopleHR task: "List the PeopleHR holiday requests waiting for my approval."
ChatGPT asks "Allow ChatGPT to use Cotlet?" before some steps. Pick Always allow, or the chat waits for your click. On a Business, Enterprise or Edu workspace, an admin has to allow custom MCP servers first.
How to connect PeopleHR to Claude
- Open Connectors in Claude and click Add. In the desktop app it is under Customize, Connectors.
- Click Add custom connector.
- Paste the name
Cotletand the URLhttps://cotlet.dev/mcp/v1/connect, then click Continue. - Keep the settings and click Add.
- A Cotlet page opens. Click Allow access.
- In a chat, click the plus button, then Connectors, and turn Cotlet on.
- Ask Claude: "Are you signed in to Cotlet through MCP?", then "Who is off next week in PeopleHR, by department?". Claude asks before it uses a Cotlet tool the first time. Click Allow.
Claude's free plan allows one custom connector. On a Team or Enterprise plan, an owner adds Cotlet in Organization settings, Connectors, and you click Connect next to it.
How to connect PeopleHR to Claude Code
Add Cotlet without a key, then sign in once in the browser:
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1/connect
Run /mcp in Claude Code, pick cotlet and sign in to Cotlet. Prefer an API key, for example on a server? Create one in the Cotlet console and use:
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 \
--header "Authorization: Bearer $COTLET_API_KEY"
How to connect PeopleHR to Codex
Create an API key in the Cotlet console, put it in the COTLET_API_KEY environment variable and add this to ~/.codex/config.toml:
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
How to connect PeopleHR to Cursor
Create an API key in the Cotlet console, put it in the COTLET_API_KEY environment variable and add this to ~/.cursor/mcp.json:
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
}
}
}
How to connect PeopleHR to Grok
Grok takes custom MCP servers on grok.com, per xAI's connectors documentation (checked 8 November 2026).
- Open grok.com/connectors and click New Connector.
- Pick Custom and paste the server URL
https://cotlet.dev/mcp/v1/connect. - Sign in to Cotlet when Grok asks, then click Allow access.
- Ask Grok: "Are you signed in to Cotlet through MCP?"
On Grok Business, an admin adds the connector first in the xAI console, under Grok Business, Connectors. The Grok chat inside X has no custom connector menu.
How to connect PeopleHR to Hermes Agent
Add Cotlet to ~/.hermes/config.yaml in the format of the Hermes MCP config reference:
mcp_servers:
cotlet:
url: "https://cotlet.dev/mcp/v1"
headers:
Authorization: "Bearer ${COTLET_API_KEY}"
trust: untrusted
Put COTLET_API_KEY in ~/.hermes/.env and check it with hermes mcp test cotlet. With trust: untrusted, Hermes runs reads at once and asks before every write. More on Hermes in our post on the Hermes Agent browser.
How to connect PeopleHR to n8n
Use the MCP Client node, or the MCP Client Tool inside an AI Agent node:
- Server Transport: HTTP Streamable
- MCP Endpoint URL:
https://cotlet.dev/mcp/v1 - Authentication: Bearer Auth, with your Cotlet API key as the token
- Tools: let the AI Agent node use Cotlet's browser tools; it reads Cotlet's PeopleHR guide first and works in your signed-in PeopleHR account
Use it for work that should run on its own, such as a Monday list of holiday requests waiting for approval, each with the clash it would cause.
Any other MCP client
Point the client at https://cotlet.dev/mcp/v1 over Streamable HTTP, with the header Authorization: Bearer <your Cotlet API key>. A client that supports OAuth sign-in can use https://cotlet.dev/mcp/v1/connect instead and needs no key. The full reference is in the MCP docs.
Step 3: ask for a first job
Pick one job you did by hand this week, ask for it, and check the result in your PeopleHR employees. For example: "Look at every holiday request for December. Approve the ones that keep two people on each team, list the rest with the clash, and ask me before each approval." Your agent asks you before it approves or declines holiday, changes an employee record or assigns a task.
No official MCP found
Does PeopleHR have an MCP server? None found. The API needs Core or higher.
PeopleHR: no MCP server found on peoplehr.com or in the MCP Registry (checked 20 Nov 2026). Its Integration API is listed on the Core, Pro and Elite+ plans.
- The Integration API needs your own code and an API key from an admin. Cotlet works in your signed-in PeopleHR account, with the approvals and screens you already use.
- PeopleHR's Zapier and Make apps have triggers only, such as New Starter and New Leaver.
- The full picture with sources: Does PeopleHR have an API or MCP server?
0/3
Official MCP server
None found
Checked 20 Nov 2026. Sources: PeopleHR Integration API overview · PeopleHR pricing · Zapier: People HR integrations
Your login, your screens
Which PeopleHR screens can your agent work in?
Your agent works on the screens your PeopleHR login opens. An owner sees everything. A team member sees what their permissions allow.
Screen
PeopleHR screens your agent can work in
Examples of what you can ask for
-
Employees
- An employee's record
- job details
- a change you approve
-
Holiday
- Holiday requests waiting
- who is off
- approvals you confirm
-
Absence
- Absence records for a person or a team
-
Tasks
- New starter and leaver tasks
- a task for a manager
-
Query Builder
- Your saved queries and their results
-
Authorisations
- Everything waiting for your approval in one list
Want the same jobs as API endpoints for n8n, Make or your own code? See PeopleHR API with Cotlet.
Encrypted, revocable
Who can see my PeopleHR session, and how do I stop it?
-
What Cotlet keeps
Your signed-in PeopleHR browser profile, encrypted with AES-256-GCM, in Finland. No password.
-
What your agent sees
The same pages your PeopleHR login shows. Nothing more.
-
When PeopleHR signs you out
You get an email with a link and sign in again yourself.
-
How to stop it
Disable PeopleHR for agents, reset the browser or delete the key, in the Cotlet console.
A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).
Asks first
Your agent asks before it changes anything Nothing is approved until you say yes.
- 1
Reads the request
Dates, team and holiday left. 2. 2
Checks the team
Who else is off on those days. 3. 3
Asks for your OK
Before it approves or declines holiday, changes an employee record or assigns a task. 4. 4
Proposes the answer
Approve or ask first, for you to confirm.
Your agent asks you before it approves or declines holiday, changes an employee record or assigns a task. Notes and saved queries are only seen by your team. Check each change in your PeopleHR employees.
Which PeopleHR actions can be undone
| Action | Undo |
|---|---|
| Approve or decline holiday | Not from Cotlet. Check PeopleHR's own rules before you allow it |
| Change an employee record | Not from Cotlet. Check PeopleHR's own rules before you allow it |
| Assign a task | Check it in PeopleHR after the change |
| Note, saved query | Check it in PeopleHR after the change |
Pay as you go
What does Cotlet cost?
- From $29
one-time pack of 5,000 credits, valid for 365 days, no subscription - 50 credits
a day of Cloud Browser for agents - 5 credits
a minute of agent work - 7 days
free trial with 2,000 credits, no card
Cotlet credit packs: price and credits
| Credits | Price, one time | Per 1,000 credits |
|---|---|---|
| 5,000 | $29 | $5.80 |
| 15,000 | $79 | $5.27 |
| 32,000 | $149 | $4.66 |
| 60,000 | $249 | $4.15 |
Cotlet is best for HR managers and team leads on PeopleHR who want ChatGPT or Claude to handle holiday approvals, starter tasks and absence questions without hiring a developer.
- Works with your own PeopleHR login, no API key needed
EU company, since 2019
Who runs Cotlet A company you can look up.
Cotlet is run by Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273), working since 2019. The founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about PeopleHR on Cotlet go to contact@cotlet.dev.
Company
Take Group sp. z o.o.
Registered
Poland, EU
VAT
PL6342984273
Working since
2019
Founders
Bart Krawczyk and Jake Slugocki
PeopleHR and AI agents: questions
Is this an official PeopleHR integration?
No. Cotlet is independent and not affiliated with PeopleHR. Your agent works through your own signed-in PeopleHR account, the way you would by hand.
Do I need the PeopleHR API for this?
No. The Integration API is for your own code and is listed on the Core, Pro and Elite+ plans. Cotlet works in your signed-in PeopleHR account on the plan you have.
Does PeopleHR have its own MCP server?
None was found on peoplehr.com or in the MCP Registry (checked 20 Nov 2026).
What can the agent not do in PeopleHR?
Your agent cannot do more than your own PeopleHR login. Payroll, salary changes and your PeopleHR subscription are jobs to keep in your own hands.
Can I use PeopleHR with n8n?
Yes. n8n connects to Cotlet with its MCP Client Tool and a Cotlet API key, and runs the same jobs on a schedule.
More HR apps on Cotlet
- HR & recruiting
Personio
Time off, employees and attendance in Personio, handled by your agent.
- HR & recruiting
BambooHR
Employees, time off and onboarding in BambooHR, done by your agent.
- HR & recruiting
CharlieHR
Approve leave, book time off, adjust allowances and offboard people.
Hand your PeopleHR approvals to your AI agent
Sign in once, connect ChatGPT or Claude, and hand over the first job today.
No card. Takes about 5 minutes.
Give your AI agents your signed-in browser.
Product: Integrations · MCP servers · APIs · API & MCP status · How it works · Pricing · Security · Custom API
Resources: Blog · API docs · Help center · Changelog · GitHub
Solutions: For developers · For automation agencies
Company: About · AI info: company facts · Contact
Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors
Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub
Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us
Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.