Crawlee MCP

A local Model Context Protocol server for web fetching, crawling, and screenshots with Crawlee. It runs over stdio, so it works with Claude Code, Claude Desktop, Codex, Cursor, and any MCP-compatible client.

Tools

Install

Requires Node.js 20 or newer. The first use of JavaScript rendering or screenshots also requires the Chromium browser:

npx playwright install chromium

Once published to npm, every client can start it with:

npx -y @patrikmichi/crawlee-mcp

Until the npm package is published, install directly from GitHub:

npx -y github:patrikmichi/crawlee-mcp

Client configuration

Claude Code

claude mcp add --transport stdio crawlee -- npx -y @patrikmichi/crawlee-mcp

Claude Desktop

Add this to your Claude Desktop configuration file:

{
  "mcpServers": {
    "crawlee": {
      "command": "npx",
      "args": ["-y", "@patrikmichi/crawlee-mcp"]
    }
  }
}

Codex

Add this to ~/.codex/config.toml:

[mcp_servers.crawlee]
command = "npx"
args = ["-y", "@patrikmichi/crawlee-mcp"]

Other MCP clients

Use the same command and arguments: npx -y @patrikmichi/crawlee-mcp.

Configuration

cp env.example .env

Development

npm install
npm start          # Run with tsx (no build needed)
npm run build      # Compile TypeScript
npm run typecheck  # Type check only

This server is intentionally local and stdio-only because JavaScript rendering and screenshots require a local Playwright browser.