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.

Try it free now

How to connect

  • 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.

  1. YOUR AI ChatGPT, Claude, Cursor, n8n or any MCP client
  2. COTLET MCP SERVER https://cotlet.dev/mcp/v1 Streamable HTTP · OAuth or API key
  3. YOUR CLOUD BROWSER Chrome in the cloud, signed in as you
  4. PEOPLEHR www.peoplehr.com

PeopleHR MCP server from Cotlet

WhatAnswer
Server URL with OAuth sign-inhttps://cotlet.dev/mcp/v1/connect for ChatGPT, Claude, Claude Code and Grok
Server URL with an API keyhttps://cotlet.dev/mcp/v1 for Codex, Cursor, Hermes Agent, n8n and other MCP clients
TransportStreamable HTTP
Tools your agent getsBrowser 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 runsYour Cloud Browser, signed in with your own PeopleHR login
What Cotlet storesThe signed-in session, encrypted. No password
StatusUnofficial. 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.

  1. 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.

  1. Open Plugins in ChatGPT and click Add.
  2. Click Add custom MCP server. Not in the menu? Turn on Developer mode in Settings, Security and login, then come back.
  3. Paste the name Cotlet and the server URL https://cotlet.dev/mcp/v1/connect. Keep Authentication on OAuth.
  4. Tick "I understand and want to continue" and click Create as a plugin.
  5. Click Connect Cotlet. A Cotlet page opens, click Allow access.
  6. In a new chat, type @Cotlet and pick it from the list.
  7. 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

  1. Open Connectors in Claude and click Add. In the desktop app it is under Customize, Connectors.
  2. Click Add custom connector.
  3. Paste the name Cotlet and the URL https://cotlet.dev/mcp/v1/connect, then click Continue.
  4. Keep the settings and click Add.
  5. A Cotlet page opens. Click Allow access.
  6. In a chat, click the plus button, then Connectors, and turn Cotlet on.
  7. 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).

  1. Open grok.com/connectors and click New Connector.
  2. Pick Custom and paste the server URL https://cotlet.dev/mcp/v1/connect.
  3. Sign in to Cotlet when Grok asks, then click Allow access.
  4. 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

Full API & MCP report

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?

Security overview

  • 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. 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

ActionUndo
Approve or decline holidayNot from Cotlet. Check PeopleHR's own rules before you allow it
Change an employee recordNot from Cotlet. Check PeopleHR's own rules before you allow it
Assign a taskCheck it in PeopleHR after the change
Note, saved queryCheck it in PeopleHR after the change

Pay as you go

What does Cotlet cost?

Full pricing

  • 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

CreditsPrice, one timePer 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.

About us

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.

Try it free now

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.