OpenEvidence MCP
About
Open-source MCP server that connects OpenEvidence clinical evidence workflows to AI clients using browser-session auth (Playwright), no API key required.
Details
- Author
- bakhtiersizhaev
- Downloads
- 327
- Categories
- Automation
Jump to
- Bridges OpenEvidence to popular MCP clients
- Uses your own browser session via Playwright storage state
- Offers four tools: auth check, history list, article fetch, ask
- Supports macOS, Windows, and Linux
- No public API token required
- Open source under Apache‑2.0
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
OpenEvidence MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Provide a captured Playwright storage state from your authenticated OpenEvidence browser session, then configure your MCP client to invoke the server. Use the provided tools (oe_auth_status, oe_history_list, oe_article_get, oe_ask) in your AI coding assistant.
oe_auth_status
Check whether the saved OpenEvidence browser session is authenticated. Use before history/article/ask tools when auth state is unknown. Returns authenticated=true/false and basic account metadata when available. Requires the local browser profile created by npm run login:session. No side effects. Can fail if the profile is missing, expired, or network access fails.
oe_history_list
List prior OpenEvidence articles from the authenticated account. Use only when the user asks to inspect prior OpenEvidence work or needs an article_id. Inputs: limit, offset, optional search, optional include_raw=false. Returns a privacy-reduced list by default; include_raw=true may expose private prior questions and must be used only with explicit user intent. Requires authenticated session. No side effects.
oe_article_get
Fetch an OpenEvidence article by article_id. Use after history lookup or oe_ask returns an article ID. Inputs: article_id UUID, optional include_raw=false. Returns normalized status, question, and answer fields by default. include_raw=true may expose private thread context and must be used only with explicit user intent. Requires authenticated session. No side effects.
oe_article_wait
Wait for an existing OpenEvidence article_id to finish, then return normalized fields. Use after oe_ask with wait_for_completion=false, especially for long research questions that may exceed MCP host timeouts. Inputs: article_id UUID, optional timeout_sec, poll_interval_ms, and include_raw=false. include_raw=true may expose private thread context and must be used only with explicit user intent. Requires authenticated session. No side effects.
oe_ask
Create an OpenEvidence research question, not medical advice or patient-specific diagnosis. For long questions, prefer wait_for_completion=false and then call oe_article_wait with the returned article_id. Use original_article_id only for true follow-up continuity; omit it for fresh questions. Returns privacy-reduced created article data and optionally normalized completed fields. Side effect: creates a question/article in the user's OpenEvidence account through the local browser profile.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"openevidence mcp": {
"openevidence": {
"command": "npx",
"args": [
"-y",
"openevidence-mcp"
]
}
}
}
}McpServers
{
"openevidence": {
"command": "npx",
"args": [
"-y",
"openevidence-mcp"
]
}
}OpenEvidence MCP
OpenEvidence MCP is an unofficial Model Context Protocol server that bridges OpenEvidence to MCP clients such as Codex CLI, Claude Desktop/Code, Cursor, Cline, and Continue.Why it exists
OpenEvidence has no public API token flow for third-party MCP integrations. This server uses your own browser session (Playwright storage state) so you can run clinical evidence workflows from your AI client.Tools
-oe_auth_status — validate account session (/api/auth/me)
- oe_history_list — list conversation history (/api/article/list)
- oe_article_get — fetch full article payload by ID
- oe_ask — ask a question and optionally wait for completion
Platform support
- macOS - Windows - Linux Repository: https://github.com/bakhtiersizhaev/openevidence-mcp Docs: https://bakhtiersizhaev.github.io/openevidence-mcp/ License: Apache-2.0Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
