How to add OMOP MCP Server to Cursor

Map clinical terminology to standardized OMOP CDM concepts using LLMs and the OMOPHub vocabulary API. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 14, 2026 · 36★ · stdio · apikey

Cursor config for OMOP MCP Server

git clone https://github.com/OHNLP/omop_mcp.git

{
  "mcpServers": {
    "omop-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "<path-to-local-repo>",
        "run",
        "omop_mcp"
      ]
    }
  }
}

Setup steps

1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the OMOP MCP Server config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of OMOP MCP Server's tools to confirm it's connected.

Before you start

uv installed (https://docs.astral.sh/uv/getting-started/installation/)
Clone of the OHNLP/omop_mcp repository
OMOPHUB_API_KEY from omophub.com for vocabulary lookups
An LLM provider API key (e.g. OpenAI, Anthropic, Azure OpenAI, OpenRouter, Groq, Hugging Face, or Google), configured via a local .env file

What OMOP MCP Server can do in Cursor

find_omop_concept

Search the OMOP vocabulary directly to look up standardized concepts.

map_clinical_terminology

Intelligently map a free-text clinical term to a standardized OMOP concept, optionally guided by the target OMOP table/field, returning the concept id, code, name, class, validity, domain, vocabulary, and a rationale.

batch_mapping

Map multiple clinical concepts at once from a CSV file.

Security

Requires an OMOPHUB_API_KEY (from omophub.com) and at least one LLM provider key (OpenAI, Anthropic, Azure OpenAI, OpenRouter, Groq, Hugging Face, or Google). Credentials are supplied via a local .env file copied from .env.template; do not commit the .env file. Clinical terms you map are sent to the configured LLM provider and the OMOPHub API.

OMOP MCP Server + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the OMOP MCP Server config there under the "mcpServers" key and restart the client.

Is OMOP MCP Server safe to use with Cursor?

What vocabulary backend does it use?

It uses the OMOPHub API (omophub.com) for vocabulary search, concept suggestion, and terminology mapping. You need an OMOPHUB_API_KEY.

Which LLM providers are supported?

The .env template includes keys for OpenAI, Anthropic, Azure OpenAI, OpenRouter, Groq, Hugging Face, and Google; fill in only the provider(s) you intend to use.

How do I run it in Claude Desktop?

Clone the repo, install uv, copy .env.template to .env and fill in your keys, then add the provided mcpServers block to claude_desktop_config.json with the path to your local repo.

View repo Full OMOP MCP Server page