OpenEvidence MCP: open-source browser-session MCP server for human and AI-agent medical workflows
SaferSkills independently audited Openevidence Mcp (Agent Skill) and scored it 65/100 (yellow). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 9 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 9 flagged
The text {match} tells the agent to skip the normal "ask the user first" gate. Used adversarially it removes the human-in-the-loop check before destructive or sensitive actions, turning a normally-gated agent into a fire-and-forget executor.
The text {match} tells the agent to skip the normal "ask the user first" gate. Used adversarially it removes the human-in-the-loop check before destructive or sensitive actions, turning a normally-gated agent into a fire-and-forget executor.
The text {match} tells the agent to skip the normal "ask the user first" gate. Used adversarially it removes the human-in-the-loop check before destructive or sensitive actions, turning a normally-gated agent into a fire-and-forget executor.
The text {match} tells the agent to skip the normal "ask the user first" gate. Used adversarially it removes the human-in-the-loop check before destructive or sensitive actions, turning a normally-gated agent into a fire-and-forget executor.
The text {match} tells the agent to skip the normal "ask the user first" gate. Used adversarially it removes the human-in-the-loop check before destructive or sensitive actions, turning a normally-gated agent into a fire-and-forget executor.
The text {match} tells the agent to skip the normal "ask the user first" gate. Used adversarially it removes the human-in-the-loop check before destructive or sensitive actions, turning a normally-gated agent into a fire-and-forget executor.
The text {match} tells the agent to skip the normal "ask the user first" gate. Used adversarially it removes the human-in-the-loop check before destructive or sensitive actions, turning a normally-gated agent into a fire-and-forget executor.
The text {match} tells the agent to skip the normal "ask the user first" gate. Used adversarially it removes the human-in-the-loop check before destructive or sensitive actions, turning a normally-gated agent into a fire-and-forget executor.
The text {match} tells the agent to skip the normal "ask the user first" gate. Used adversarially it removes the human-in-the-loop check before destructive or sensitive actions, turning a normally-gated agent into a fire-and-forget executor.
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
OpenEvidence MCP is an unofficial Model Context Protocol server that connects OpenEvidence to Codex, Claude Code, Claude Desktop, Cursor, Cline, Continue, and other MCP-compatible clients through your own authenticated browser session.
[!IMPORTANT] This project is unofficial and is not affiliated with OpenEvidence. It does not provide medical advice, does not bypass access controls, and should only be used with your own OpenEvidence account in compliance with applicable terms, privacy rules, and clinical governance requirements.
Translations: Русский | Español | 简体中文 | 繁體中文(台灣) | 한국어 | हिन्दी
Using Codex, Claude Code, Cursor, or another local AI coding agent? You can let the agent handle the entire setup, compilation, and local MCP configuration for you!
Copy and paste this short bootstrap prompt directly into your local AI coding assistant:
Please install OpenEvidence MCP for me: clone https://github.com/bakhtiersizhaev/openevidence-mcp, install dependencies, run build, auto-configure this MCP server in my local client (Claude Desktop/Codex/Cursor), guide me through the one-time Edge/Chrome login using `npm run login:session`, and run `npm run smoke` to verify. Keep everything strictly local and secure.For the comprehensive, step-by-step setup playbook and rules, see [docs/AGENT_INSTALL_PROMPT.md](docs/AGENT_INSTALL_PROMPT.md).
OpenEvidence MCP runs a local stdio MCP server that lets MCP clients use your existing OpenEvidence browser session for:
No official OpenEvidence API token is required.
This project is designed for MCP-compatible clients and local agent workflows. Only Codex and Claude-style local configuration examples are maintained in this repository unless otherwise noted.
| Client | Status | Notes |
|---|---|---|
| OpenAI Codex / Codex CLI / Codex app | Target | Recommended local MCP workflow. |
| Claude Code | Target | Recommended agent workflow. |
| Claude Desktop / Claude app with MCP support | Target | Local MCP server configuration. |
| Cursor | Compatible | MCP-compatible IDE workflow. |
| Cline | Compatible | VS Code agent workflow. |
| Continue | Compatible | Open-source IDE assistant workflow. |
| VS Code / GitHub Copilot environments with MCP support | Experimental | Depends on local MCP support and client configuration. |
| Windsurf / Zed / Replit / Sourcegraph-style MCP hosts | Experimental | Not guaranteed unless tested. |
| Gemini CLI / Google Antigravity-style agent environments | Experimental | Watchlist/ecosystem target, not a maintained example. |
Other MCP-compatible hosts may work as well, but the examples in this repository focus on Codex and Claude-style local MCP configuration.
| Tool | Purpose | Auth required | Side effects |
|---|---|---|---|
oe_auth_status | Checks whether the saved OpenEvidence browser session is authenticated. | Yes, local browser profile must be logged in. | None. |
oe_history_list | Lists prior OpenEvidence articles with optional pagination and search. Returns a privacy-reduced list unless include_raw=true is explicitly requested. | Yes. | None. |
oe_article_get | Fetches an article by ID and returns normalized fields (status, is_complete, question, answer_text). Raw payload is opt-in with include_raw=true. | Yes. | None. |
oe_article_wait | Waits for an existing article ID to complete; useful after non-blocking oe_ask. | Yes. | None. |
oe_ask | Creates an OpenEvidence research question and optionally waits for the article to complete. | Yes. | Creates a question/article in your OpenEvidence account. |
The MCP server includes built-in instructions and a prompt named openevidence_research_workflow for clients that expose MCP prompts.
Recommended agent workflow:
oe_auth_status when auth state is unknown.oe_history_list only when the user wants prior OpenEvidence work or an article ID.oe_article_get when you already have an article ID.oe_ask with wait_for_completion=false, then call oe_article_wait with the returned article_id.original_article_id only for true follow-up continuity. Omit it for fresh questions to avoid stale thread context.Related commands:
| Command | Purpose |
|---|---|
npm run login:session | Recommended one-time login. Opens Chrome/Edge with the local OpenEvidence MCP profile. |
npm run login | Legacy/development Playwright login flow that also uses the local profile. |
npm run login:browser | Legacy system-browser login/export flow for debugging Google SSO issues. |
npm run smoke | Verifies auth and basic OpenEvidence connectivity. |
npx playwright install chromium)OpenEvidence availability may depend on region, account eligibility, and OpenEvidence policy. Public materials in May 2026 indicate verified U.S. HCP/NPI-centered access and EU/U.K. unavailability; this project does not bypass those restrictions.
Useful references:
git clone https://github.com/bakhtiersizhaev/openevidence-mcp.git
cd openevidence-mcp
./scripts/setup-macos.sh
npm run login:session
npm run smokegit clone https://github.com/bakhtiersizhaev/openevidence-mcp.git
cd openevidence-mcp
./scripts/setup-ubuntu.sh
npm run login:session
npm run smokegit clone https://github.com/bakhtiersizhaev/openevidence-mcp.git
cd openevidence-mcp
.\scripts\setup-windows.ps1
npm run login:session
npm run smokeRecommended one-time login:
npm run login:sessionThe command opens Chrome or Edge with a local OpenEvidence MCP browser profile. Sign in to OpenEvidence with your own account, confirm the normal OpenEvidence page loads, close that browser window, return to the terminal, and press Enter.
Default local profile path:
~/.openevidence-mcp/browser-profile%USERPROFILE%\.openevidence-mcp\browser-profileThe MCP server reuses this same local profile during its process lifetime. It may start a minimized local browser process for OpenEvidence calls, but it does not install an extension, expose a public network service, export cookies, or ask for your password.
Legacy/development flow:
npm run loginIf Google sign-in says the browser or app may not be secure during the legacy flow, use the session login instead:
npm run login:sessionDo not share browser profile files, storage-state files, cookies, screenshots with private account data, or patient-identifiable information.
Build before registering the server:
npm run buildYou can automatically register the OpenEvidence MCP server with your favorite client using the built-in installer:
claude-app): npx openevidence-mcp install --client claude-app
# or via npm shortcut:
npm run install:claude-appcodex-app): npx openevidence-mcp install --client codex-app
# or via npm shortcut:
npm run install:codex-appclaude-code): npx openevidence-mcp install --client claude-code
# or via npm shortcut:
npm run install:claude-codecodex-cli): npx openevidence-mcp install --client codex-cli
# or via npm shortcut:
npm run install:codex-cliantigravity): npx openevidence-mcp install --client antigravity
# or via npm shortcut:
npm run install:antigravitycursor): npx openevidence-mcp install --client cursor
# or via npm shortcut:
npm run install:cursorwindsurf): npx openevidence-mcp install --client windsurf
# or via npm shortcut:
npm run install:windsurfTo uninstall, you can run:
npx openevidence-mcp uninstall --client <client-id>Add this to ~/.codex/config.toml:
[mcp_servers.openevidence]
command = "node"
args = ["/ABSOLUTE/PATH/openevidence-mcp/dist/server.js"]
startup_timeout_sec = 60Windows example:
[mcp_servers.openevidence]
command = "node"
args = ["C:\\Users\\<user>\\openevidence-mcp\\dist\\server.js"]
startup_timeout_sec = 60Add this to claude_desktop_config.json:
{
"mcpServers": {
"openevidence": {
"command": "node",
"args": ["/ABSOLUTE/PATH/openevidence-mcp/dist/server.js"]
}
}
}Use the same stdio server shape if your client supports MCP server command/args configuration:
{
"command": "node",
"args": ["/ABSOLUTE/PATH/openevidence-mcp/dist/server.js"]
}Example configs are in examples/.
npm run smokeExpected result with a valid session:
ok: trueauthenticated: trueIf smoke fails with an auth error, run npm run login:session again. Smoke requires a real OpenEvidence account session and will not pass in a clean CI environment unless a local session profile is available.
By default, smoke output redacts account and history content. Use npm run smoke -- --verbose only in a private terminal if raw account/history payloads are needed for debugging.
Developer checks:
npm test
npm run build
npm run checkstorage-state.json, and cookies as secrets..env, session state, screenshots with account data, or patient-identifiable information.SECURITY.md for vulnerability reporting and supported scope.See docs/TROUBLESHOOTING.md for detailed recovery steps.
Common fixes:
authenticated: false: rerun npm run login:session.npm run login:session.npx playwright install chromium.npm run build succeeded and use an absolute path to dist/server.js.node --version is 20 or newer.oe_ask cannot find the question input or submit button: OpenEvidence UI may have changed; open an issue with sanitized logs and no private account or patient data.Apache-2.0 (LICENSE) + NOTICE.
If you redistribute, fork, or build derivative versions, keep attribution to:
https://github.com/bakhtiersizhaev/openevidence-mcpSuggested attribution line:
Based on OpenEvidence MCP by Bakhtier Sizhaev - https://github.com/bakhtiersizhaev/openevidence-mcp<a href="https://star-history.com/#bakhtiersizhaev/openevidence-mcp&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=bakhtiersizhaev/openevidence-mcp&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=bakhtiersizhaev/openevidence-mcp&type=Date" /> <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=bakhtiersizhaev/openevidence-mcp&type=Date" /> </picture> </a>
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.