# openevidence-mcp

Connects an MCP client to OpenEvidence through your authenticated browser session. Use it to ask research questions and retrieve articles from your account history.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 48
- Author: bakhtiersizhaev
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bakhtiersizhaev/openevidence-mcp
- Updated: 2026-09-25
- HTML: https://affpapa.org/en/nevibecode/mcp/openevidence-mcp

## What it does

This local stdio server gives MCP clients access to an existing OpenEvidence browser session. It can check login status, list past questions and articles, fetch an article by ID, or submit a new research question. For longer requests, the client can wait for the article to finish.

You need Node.js 20+, npm 10+, an OpenEvidence account, and Chromium installed through Playwright. Sign in with `npm run login:session`; an API token is not needed. The project is unofficial and does not provide medical advice. Calling `oe_ask` creates a question or article in your account.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add openevidence-mcp -- npx -y openevidence-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add openevidence-mcp -- npx -y openevidence-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "openevidence-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "openevidence-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "openevidence-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "openevidence-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add openevidence-mcp npx -y openevidence-mcp
```

## When to use it
- check whether the saved OpenEvidence session is logged in
- find a previous article or question in account history
- retrieve an article using its ID
- submit a research question and wait for its article

## Example prompts
- Check my OpenEvidence login state with `oe_auth_status`.
- Look through my previous OpenEvidence articles for this topic using `oe_history_list`.
- Ask OpenEvidence this research question with `oe_ask` and wait for the article to finish.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

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