Skip to main content
Glama

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

Tool

Description

fetch_url

Fetch a single URL and return clean markdown

fetch_multiple

Fetch multiple URLs in parallel

crawl

Crawl a site, discover links, and return page content

screenshot

Take a PNG screenshot of a page

ping

Health check

Related MCP server: weblens-mcp

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

Variable

Required

Description

CRAWLEE_PROXY_URLS

No

Comma-separated proxy URLs for rotation

CRAWLEE_TIMEOUT_MS

No

Request timeout in ms (default: 30000)

CRAWLEE_STEALTH

No

Set to false to disable stealth mode (default: true)

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.

Available Tools

5 tools
crawlA

Crawl a website starting from a seed URL, following discovered links across multiple pages. Returns an array of {url, title, content} objects. Use link_pattern to restrict crawling to specific URL patterns (e.g. "https://example.com/blog/**").

Inputs: url (required), label, max_pages, render_js, +3 more.

fetch_multipleA

Fetch multiple URLs in parallel and return an array of {url, content, error} objects. Useful for bulk research or comparison tasks.

Inputs: urls (required), render_js.

fetch_urlB

Fetch a web page and return its content as clean markdown. Use render_js=true for JavaScript-heavy pages (SPAs, Twitter/X, etc). Use render_js=false for fast HTML-only fetching.

Inputs: url (required), render_js, extract_content.

pingB

Check that the crawlee MCP server is running.

Inputs: no named parameters.

screenshotB

Take a screenshot of a web page and return it as a base64-encoded PNG image.

Inputs: url (required), full_page.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: fetching a single page, fetching multiple pages in parallel, taking a screenshot, health checking, and crawling a website. There is no overlap or ambiguity between the tools.

    Naming Consistency5/5

    All tool names follow a consistent verb-based pattern using lowercase and underscores where needed (e.g., fetch_url, fetch_multiple). No mixing of styles like camelCase or inconsistent verb forms.

    Tool Count5/5

    With 5 tools, the server is well-scoped for web crawling and scraping. Each tool earns its place: single fetch, batch fetch, screenshot, full crawl, and a health check. The count is neither too thin nor excessive.

    Completeness4/5

    The tool set covers the core workflows of fetching pages and crawling sites, with parallel fetching and screenshot support. Minor gaps exist, such as advanced extraction capabilities or session management, but the surface is practical for typical use cases.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables web scraping and crawling capabilities for LLM clients, supporting single-page scraping, multi-page website crawling, and web search with multiple engines (Playwright, Cheerio, Puppeteer) and flexible output formats including markdown, HTML, text, and screenshots.
      7
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to fetch and render web pages (including JavaScript-heavy SPAs) with headless Chromium, extract readable content with Mozilla Readability, capture navigation links, download images, and return a clean markdown file path.
      1
      17 npm
      ISC