# Dejo

> Dejo is an open-source MCP server for browser automation. Browser MCP that records website routes and replays them without model calls. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://dejo.run
- **Repository:** https://github.com/dejohq/dejo-mcp
- **MCP Registry name:** io.github.dejohq/dejo-mcp
- **Categories:** browser automation, developer tools
- **Listing updated:** 2026-11-14

## About

Dejo watches your agent walk a site once, signing in, clicking and reading, and saves the route as a trail. Each step keeps a plain-language purpose, up to nine ways to find its element and a check that it landed, such as a changed address or a downloaded file. Later runs replay in plain code as a single tool call, and a failed check stops at that exact step instead of clicking blindly.

When a site changes, only the broken step is relearned, and if over half the steps break the site is learned again. Dejo records who is signed in and stops before step one if a replay finds a different account. Popups such as cookie banners are closed safely, and it never buys, pays, sends or signs up on its own.

It keeps its memory in a local file and needs Python 3.11 or newer and a Chromium download of about 150 MB. A dejo command-line tool can run, show and forget trails.

## Features

- **Learn once, replay:** Saves a route and replays it as one tool call.
- **Step checks:** Each step verifies it landed or the run stops there.
- **Targeted repair:** Only the broken step is relearned.
- **Account guard:** Stops if a different account is signed in.
- **Multiple profiles:** Several signed-in accounts side by side.
- **Forget on demand:** One command wipes what it knows about a site.

## Good for

- Repeat a daily website task cheaply
- Count issues or read figures from a site on a schedule
- Work across customer, vendor and admin logins
- Run saved routes from cron with JSON output

## Install

### Claude Code (Terminal)

```sh
claude mcp add dejo-mcp -- uvx dejo-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "dejo-mcp": {
      "command": "uvx",
      "args": [
        "dejo-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "dejo-mcp": {
      "command": "uvx",
      "args": [
        "dejo-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "dejo-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "dejo-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "dejo-mcp": {
      "command": "uvx",
      "args": [
        "dejo-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "dejo-mcp": {
      "command": "uvx",
      "args": [
        "dejo-mcp"
      ]
    }
  }
}
```

## FAQ

### Does it call a model itself?

No. The README says Dejo never calls a model; your agent does the thinking.

### Do I need an API key?

No API key and no account.

### What happens when a site changes?

It stops at the broken step, your agent fixes that step, and the rest is replayed.

### What are the requirements?

Python 3.11 or newer and a Chromium browser download.

### Is Dejo free?

Yes. Dejo is open source, so you can use and self-host it for free.

### How do I add Dejo to Claude Code?

Run this command in your terminal: claude mcp add dejo-mcp -- uvx dejo-mcp

### What are the best alternatives to Dejo?

The closest alternatives to Dejo are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/dejo
