PeoplePerHour by Cotlet — Claude Code MCP server: project search
PeoplePerHour by Cotlet — an MCP server for finding projects, freelancers and Offers on PeoplePerHour. Reads briefs, profiles and reviews via your Chrome session.
no license ★ 6 updated 2026-10-24
claude mcp add --transport http peopleperhour https://cotlet.dev/mcp/v1/peopleperhour/connectWhat PeoplePerHour by Cotlet does
The server provides 17 tools for working with PeoplePerHour: find active projects and read their complete briefs, locate freelancers and Offers with recent reviews, maintain watchlists and saved searches with email alerts, view median budgets by category, access your posted projects and WorkStreams. PeoplePerHour has no official API — the server calls the site's internal JSON endpoints using cookies from your Chrome.
The server runs locally on Python 3.11+. The peopleperhour-mcp connect command attaches to Chrome via DevTools Protocol, extracts the peopleperhour.com session and stores it in ~/.config/peopleperhour-api-mcp/session.json. No browser runs during operation — requests go through curl_cffi with Chrome's TLS fingerprint. Of the 17 tools, 13 only read data; the other 4 modify your watchlists and saved searches. Nothing here sends proposals, buys Offers or spends Proposal credits.
Works on macOS, Linux and Windows. Requires Chrome 144+ with remote debugging enabled and any PeoplePerHour account — a free buyer account covers all features. The PolyForm Noncommercial license permits personal noncommercial use only; for team or business deployment, the author provides a hosted version at cotlet.dev.
What it helps with
- locate relevant projects on PeoplePerHour and retrieve full briefs
- track freelancers with specific skills and review their latest feedback
- gather median budgets across categories for project estimation
- maintain watchlists and saved searches with email notifications
Example prompts for the agent
- Find all projects matching 'web design' with a limit of 5 results
- Show freelancer profiles specializing in React
- Retrieve my posted projects and notifications
How to install PeoplePerHour by Cotlet
1Platform CLI: remote server
claude mcp add --transport http peopleperhour https://cotlet.dev/mcp/v1/peopleperhour/connect2Platform CLI
claude mcp add peopleperhour-by-cotlet -- uvx peopleperhour-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from peopleperhour-api-mcp <command>
1Platform CLI: remote server
codex mcp add peopleperhour-by-cotlet --url https://cotlet.dev/mcp/v1/peopleperhour/connect2Platform CLI
codex mcp add peopleperhour-by-cotlet -- uvx peopleperhour-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from peopleperhour-api-mcp <command>
Config file
{
"mcpServers": {
"peopleperhour-by-cotlet": {
"url": "https://cotlet.dev/mcp/v1/peopleperhour/connect"
}
}
}{
"mcpServers": {
"peopleperhour-by-cotlet": {
"command": "uvx",
"args": [
"peopleperhour-api-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from peopleperhour-api-mcp <command>
Config file
{
"servers": {
"peopleperhour-by-cotlet": {
"type": "http",
"url": "https://cotlet.dev/mcp/v1/peopleperhour/connect"
}
}
}{
"servers": {
"peopleperhour-by-cotlet": {
"type": "stdio",
"command": "uvx",
"args": [
"peopleperhour-api-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from peopleperhour-api-mcp <command>
1Platform CLI: remote server
gemini mcp add -t http peopleperhour-by-cotlet https://cotlet.dev/mcp/v1/peopleperhour/connect2Platform CLI
gemini mcp add peopleperhour-by-cotlet uvx peopleperhour-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from peopleperhour-api-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about PeoplePerHour by Cotlet
How to install PeoplePerHour by Cotlet in Claude Code?
Run claude mcp add --transport http peopleperhour https://cotlet.dev/mcp/v1/peopleperhour/connect for the hosted version or claude mcp add peopleperhour-by-cotlet -- uvx peopleperhour-api-mcp for the local server.
What does PeoplePerHour by Cotlet do?
Provides 17 tools for finding projects, freelancers and Offers on PeoplePerHour, reading briefs, profiles and reviews. Operates via the site's JSON API with your Chrome session.
Does the server require a paid PeoplePerHour account?
No, a free buyer account is sufficient for all 17 tools. The server does not spend Proposal credits or send proposals.