# Backlot

> Backlot is an open-source MCP server for communication. Run Slack, Gmail, Drive, GitHub and Jira APIs locally over one test corpus. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Repository:** https://github.com/brekkylab/backlot
- **MCP Registry name:** io.github.brekkylab/backlot
- **Categories:** communication, developer tools
- **Listing updated:** 2026-11-15

## About

Backlot is aimed at developers who need the behaviour of an enterprise API, not only a canned response. It serves vendor-shaped endpoints, including pagination, authentication, errors and per-document access controls, from one SQLite corpus, so official SDKs work after changing a single base URL.

After pip install, backlot import --bundled loads a sample corpus and backlot serve exposes every supported API on one local port. You can also import your own JSONL corpus, one source document per line, and every user in it gets deterministic tokens so you can check that one caller never sees another's documents. It emulates a documented subset of each API, listed in an endpoint matrix, rather than every vendor endpoint.

Running backlot mcp serves the sources to an agent as MCP tools over stdio, optionally answering as a given user. Write APIs exist for some vendors, so an agent that acts can be graded on what it did and the corpus reset between runs.

## Features

- **Vendor-shaped responses:** Reproduces pagination, auth, errors and response shapes.
- **Per-document ACLs:** Generated users, groups and tokens enforce who sees what.
- **Many services in one process:** Slack, Gmail, Drive, Teams, GitHub, Jira, Confluence, Notion, Linear, HubSpot, Fireflies and S3.
- **Your own corpus:** Import a JSONL file and validate it with a dry run.
- **MCP mode:** backlot mcp exposes every source to an agent over stdio.
- **Write overlay:** Lets agents that act be graded, then reset the corpus.

## Good for

- Test an integration without a vendor account or OAuth approval
- Run CI with no secrets or network
- Evaluate a RAG pipeline against fixed data
- Grade an agent's actions against a resettable workspace
- Reproduce a parser bug with a shaped test document

## Install

### Claude Code (Terminal)

```sh
claude mcp add backlot -- uvx backlot
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "backlot": {
      "command": "uvx",
      "args": [
        "backlot"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "backlot": {
      "command": "uvx",
      "args": [
        "backlot"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "backlot": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "backlot"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "backlot": {
      "command": "uvx",
      "args": [
        "backlot"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "backlot": {
      "command": "uvx",
      "args": [
        "backlot"
      ]
    }
  }
}
```

## FAQ

### Do I need vendor accounts?

No. Backlot supplies the data and credentials locally.

### Does it cover every endpoint?

No, only the documented subset listed in its supported-sources matrix.

### How do I install it?

pip install backlot, then backlot import --bundled and backlot serve.

### Can agents use it?

Yes, backlot mcp serves the sources as MCP tools over stdio.

### Is Backlot free?

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

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

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

### What are the best alternatives to Backlot?

The closest alternatives to Backlot are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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