# briar

> briar is an open-source MCP server for productivity. Local CLI that turns GitHub, Jira, Linear and cloud history into a store agents can query. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://usebriar.com
- **Repository:** https://github.com/iklobato/briar
- **MCP Registry name:** io.github.iklobato/briar
- **Categories:** productivity, developer tools, knowledge and memory
- **Listing updated:** 2026-11-15

## About

Briar's pitch is that a coding assistant guesses because it does not know your team: which tests you run, who reviews what, how pull requests usually look. It collects that context with 23 extractors covering PR history, reviewer habits, CI health, tickets, cloud inventory and meetings, and writes it as plain markdown to a local folder or to Postgres.

The MCP server, started with briar mcp serve and shipped as a Docker image, shares that knowledge with any MCP client and offers 10 tools. The same CLI also runs agents: briar agent implement takes a Jira, Linear or GitHub ticket to a draft pull request, briar agent prfix answers open review comments with one commit per thread, and briar plan run works through a board card by card. Agents never force-push, and there is no merge command, so a person reviews and merges.

There is no briar server or account. Coding agents run on Anthropic with your own key, and tokens stay in a local file or in AWS Secrets Manager, SSM or Vault. It can also write the facts into CLAUDE.md.

## Features

- **23 extractors:** Mine PR history, CI health, tickets, cloud inventory and meeting notes into markdown.
- **Ticket to draft PR:** An agent writes code in a clean worktree, runs tests and opens a draft pull request.
- **Review-comment fixes:** Answers open PR comments with one commit per thread.
- **Board-level planning:** Works a Jira board or GitHub Project card by card, building on earlier branches.
- **Local operation:** Runs on your machine with your own keys and no briar account.

## Good for

- Give a coding agent your team's conventions before it writes code
- Turn a ticket into a draft PR
- Summarise open PRs and flaky workflows at the start of the day
- Feed team history into CLAUDE.md
- Keep a journal of what an agent picked and why

## Install

### Claude Code (Terminal)

```sh
claude mcp add briar -- docker run -i --rm docker.io/iklob1/briar:1.1.94
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "briar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/iklob1/briar:1.1.94"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "briar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/iklob1/briar:1.1.94"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "briar": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/iklob1/briar:1.1.94"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "briar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/iklob1/briar:1.1.94"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "briar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/iklob1/briar:1.1.94"
      ]
    }
  }
}
```

## FAQ

### Can briar merge pull requests?

No. Agents open draft PRs only and the project has no merge command.

### Does it need an account?

No. There is no briar server or account; it talks only to services you configure.

### Which sources can it read?

GitHub, Bitbucket, Jira, Linear, AWS, GCP, Azure, Fireflies and Slack.

### How many MCP tools does it offer?

The README says briar mcp serve offers 10 tools.

### Is briar free?

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

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

Run this command in your terminal: claude mcp add briar -- docker run -i --rm docker.io/iklob1/briar:1.1.94

### What are the best alternatives to briar?

The closest alternatives to briar 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.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [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.

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