# PeoplePerHour by Cotlet

PeoplePerHour by Cotlet — an MCP server for finding projects, freelancers and Offers on PeoplePerHour. Reads briefs, profiles and reviews via your Chrome session.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: cotletdev
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cotletdev/peopleperhour-api-mcp-server
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/peopleperhour-by-cotlet

## What it 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`.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://cotlet.dev/mcp/v1/peopleperhour/connect`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http peopleperhour https://cotlet.dev/mcp/v1/peopleperhour/connect
```

2. **Platform CLI**
```bash
claude mcp add peopleperhour-by-cotlet -- uvx peopleperhour-api-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from peopleperhour-api-mcp <command>

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add peopleperhour-by-cotlet --url https://cotlet.dev/mcp/v1/peopleperhour/connect
```

2. **Platform CLI**
```bash
codex mcp add peopleperhour-by-cotlet -- uvx peopleperhour-api-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from peopleperhour-api-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "peopleperhour-by-cotlet": {
            "url": "https://cotlet.dev/mcp/v1/peopleperhour/connect"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "peopleperhour-by-cotlet": {
            "type": "http",
            "url": "https://cotlet.dev/mcp/v1/peopleperhour/connect"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http peopleperhour-by-cotlet https://cotlet.dev/mcp/v1/peopleperhour/connect
```

2. **Platform CLI**
```bash
gemini mcp add peopleperhour-by-cotlet uvx peopleperhour-api-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from peopleperhour-api-mcp <command>

## When to use it
- 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
- Find all projects matching 'web design' with a limit of 5 results
- Show freelancer profiles specializing in React
- Retrieve my posted projects and notifications

## Similar
- [Cotlet](https://affpapa.org/en/nevibecode/mcp/cotlet.md) — MCP server · ★ 7 repo stars
- [Substack by Cotlet](https://affpapa.org/en/nevibecode/mcp/substack-by-cotlet.md) — MCP server · ★ 6 repo stars
- [agent-webbridge](https://affpapa.org/en/nevibecode/mcp/agent-webbridge.md) — MCP server · ★ 13 repo stars
- [chrome-automation](https://affpapa.org/en/nevibecode/skills/chrome-automation.md) — skill · 4000 installs
- [browser](https://affpapa.org/en/nevibecode/skills/stellarlinkco-browser.md) — skill · 202 installs
- [chrome-devtools-axi](https://affpapa.org/en/nevibecode/skills/chrome-devtools-axi.md) — skill · 9100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
