# OpenReview MCP Server

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)

An MCP server that connects Claude to [OpenReview](https://openreview.net) for conference reviewer and area chair workflows.

## Setup

1. Install dependencies:
   ```bash
   cd openreview-mcp
   uv sync
   ```

2. Create a `.env` file from the example:
   ```bash
   cp .env.example .env
   ```

3. Edit `.env` with your OpenReview credentials:
   ```
   OPENREVIEW_USERNAME=your_email@example.com
   OPENREVIEW_PASSWORD=your_password
   OPENREVIEW_BASEURL=https://api2.openreview.net
   ```

## Claude Code Configuration

Add to `~/.claude/settings.json`:

```json
{
  "mcpServers": {
    "openreview": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/openreview-mcp", "python", "-m", "openreview_mcp"]
    }
  }
}
```

## Available Tools

### Read Tools
- **list_venues** — List venues where you have active roles
- **list_assignments** — List papers assigned to you
- **get_submission** — Get full submission details
- **get_pdf** — Download a paper's PDF for analysis
- **get_reviews** — Get all reviews for a paper
- **get_review_status** — Check review completion across your assigned papers
- **get_discussion** — Get discussion threads on a paper

### Write Tools (preview + confirm)
- **submit_review** — Prepare and submit a review
- **edit_review** — Edit your existing review
- **submit_meta_review** — Prepare and submit a meta-review
- **post_comment** — Post a comment on a submission
- **message_reviewer** — Send a private message to a reviewer (visible to ACs, SACs, PCs)
- **confirm_submission** — Confirm and post a pending write action

Write tools return a preview first. You must call `confirm_submission` with the confirmation ID to actually post to OpenReview.

## Development

```bash
uv sync --all-extras
uv run pytest
```

See [CONTRIBUTING.md](CONTRIBUTING.md) for details.

## License

MIT — see [LICENSE](LICENSE) for details.