# Dejo

Dejo stores website workflows and replays them through an MCP server. Use it for recurring browser tasks, such as checking a page or working through a portal.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: dejohq
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dejohq/dejo-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/dejo

## What it does

On the first visit, the agent uses a browser to explore a site. Dejo turns those actions into a route with checks; later, it replays the route and verifies each step. If the site changes, the agent can revise the broken step while keeping the rest of the route.

Routes live in a local file and include ways to locate page controls plus checks for successful actions. Dejo also keeps a map of visited pages, though it reflects the last time each page was seen. You need Python 3.11 or newer and Chromium installed through Playwright. No API key or account is required; browser actions will not run without Chromium.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add dejo-mcp -- uvx dejo-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from dejo-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add dejo -- uvx dejo-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from dejo-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "dejo": {
            "command": "uvx",
            "args": [
                "dejo-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from dejo-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "dejo": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "dejo-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from dejo-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add dejo uvx dejo-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from dejo-mcp <command>

## When to use it
- replay a saved workflow on a website
- check whether a browser action succeeded
- repair a route after a site change
- find controls on pages visited earlier

## Example prompts
- Check how many open issues appear on the project page.
- Run the saved portal login workflow and tell me what happened.
- Find the download control on a page we have already visited.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

---
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