Skip to main content
skill CX Codex

reactome-database · lifangda — Claude Code skill: pathway analysis and setup

reactome-database is a Claude Code skill that queries Reactome for pathway details, gene mappings, interactions, and enrichment results. It analyzes gene lists or expression data.

MIT 1 installs ★ 43 updated 2025-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add lifangda/claude-plugins --skill reactome-database -a claude-code
Open on GitHub

What reactome-database does

The skill retrieves pathway, reaction, and molecular interaction data, and maps genes or proteins to biological processes. For analysis, it submits identifier lists or expression tables to the Reactome Analysis Service. Results include enriched pathways and statistical measures, and can be viewed in the Reactome Pathway Browser.

The package includes an API reference and scripts/reactome_query.py for common queries. Expression analysis requires a TSV whose header starts with #; decimal values must use a period. Analysis tokens remain valid for 7 days. The reactome2py package still works, but is no longer actively maintained, so direct REST API requests are the better route for current functionality.

What it helps with

  • find enriched pathways from a gene or protein list
  • map genes and proteins to biological processes
  • analyze expression values in a TSV file
  • retrieve pathway reactions and participating molecules
  • compare pathway data across species

Example prompts for the agent

  • Find enriched pathways for the genes TP53, BRCA1, and EGFR.
  • Analyze the expression data in expression_data.tsv and show the related pathways.
  • Retrieve pathway details and participating molecules for R-HSA-69278.

How to install reactome-database

1Skills CLI (Vercel)

npx skills add lifangda/claude-plugins --skill reactome-database -a claude-code

2Manually: put the files in place

~/.claude/skills/reactome-database/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/reactome-database/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about reactome-database

How do I install reactome-database in Claude Code?

Run npx skills add lifangda/claude-plugins --skill reactome-database -a claude-code. The skill file is placed at ~/.claude/skills/reactome-database/SKILL.md.

What does reactome-database do?

It queries the Reactome REST API for pathway and interaction data, maps gene and protein identifiers, and analyzes gene lists or expression datasets.

What format does expression analysis expect?

Use a TSV with a header that begins with #. Put identifiers in the first column and numeric expression values in the following columns, using a period for decimals.

Source text

SKILL.md · MIT
---
name: reactome-database
description: "Query Reactome REST API for pathway analysis, enrichment, gene-pathway mapping, disease pathways, molecular interactions, expression analysis, for systems biology studies."
---

# Reactome Database

## Overview

Reactome is a free, open-source, curated pathway database with 2,825+ human pathways. Query biological pathways, perform overrepresentation and expression analysis, map genes to pathways, explore molecular interactions via REST API and Python client for systems biology research.

## When to Use This Skill

This skill should be used when:
- Performing pathway enrichment analysis on gene or protein lists
- Analyzing gene expression data to identify relevant biological pathways
- Querying specific pathway information, reactions, or molecular interactions
- Mapping genes or proteins to biological pathways and processes
- Exploring disease-related pathways and mechanisms
- Visualizing analysis results in the Reactome Pathway Browser
- Conducting comparative pathway analysis across species

## Core Capabilities

Reactome provides two main API services and a Python client library:

### 1. Content Service - Data Retrieval

Query and retrieve biological pathway data, molecular interactions, and entity information.

**Common operations:**
- Retrieve pathway information and hierarchies
- Query specific entities (proteins, reactions, complexes)
- Get participating molecules in pathways
- Access database version and metadata
- Explore pathway compartments and locations

**API Base URL:** `https://reactome.org/ContentService`

### 2. Analysis Service - Pathway Analysis

Perform computational analysis on gene lists and expression data.

**Analysis types:**
- **Overrepresentation Analysis**: Identify statistically significant pathways from gene/protein lists
- **Expression Data Analysis**: Analyze gene expression datasets to find relevant pathways
- **Species Comparison**: Compare pathway data across different organisms

**API Base URL:** `https://reactome.org/AnalysisService`

### 3. reactome2py Python Package

Python client library that wraps Reactome API calls for easier programmatic access.

**Installation:**
```bash
pip install reactome2py
```

**Note:** The reactome2py package (version 3.0.0, released January 2021) is functional but not actively maintained. For the most up-to-date functionality, consider using direct REST API calls.

## Querying Pathway Data

### Using Content Service REST API

The Content Service uses REST protocol and returns data in JSON or plain text formats.

**Get database version:**
```python
import requests

response = requests.get("https://reactome.org/ContentService/data/database/version")
version = response.text
print(f"Reactome version: {version}")
```

**Query a specific entity:**
```python
import requests

entity_id = "R-HSA-69278"  # Example pathway ID
response = requests.get(f"https://reactome.org/ContentService/data/query/{entity_id}")
data = response.json()
```

**Get participating molecules in a pathway:**
```python
import requests

event_id = "R-HSA-69278"
response = requests.get(
    f"https://reactome.org/ContentService/data/event/{event_id}/participatingPhysicalEntities"
)
molecules = response.json()
```

### Using reactome2py Package

```python
import reactome2py
from reactome2py import content

# Query pathway information
pathway_info = content.query_by_id("R-HSA-69278")

# Get database version
version = content.get_database_version()
```

**For detailed API endpoints and parameters**, refer to `references/api_reference.md` in this skill.

## Performing Pathway Analysis

### Overrepresentation Analysis

Submit a list of gene/protein identifiers to find enriched pathways.

**Using REST API:**
```python
import requests

# Prepare identifier list
identifiers = ["TP53", "BRCA1", "EGFR", "MYC"]
data = "\n".join(identifiers)

# Submit analysis
response = requests.post(
    "https://reactome.org/AnalysisService/identifiers/",
    headers={"Content-Type": "text/plain"},
    data=data
)

result = response.json()
token = result["summary"]["token"]  # Save token to retrieve results later

# Access pathways
for pathway in result["pathways"]:
    print(f"{pathway['stId']}: {pathway['name']} (p-value: {pathway['entities']['pValue']})")
```

**Retrieve analysis by token:**
```python
# Token is valid for 7 days
response = requests.get(f"https://reactome.org/AnalysisService/token/{token}")
results = response.json()
```

### Expression Data Analysis

Analyze gene expression datasets with quantitative values.

**Input format (TSV with header starting with #):**
```
#Gene	Sample1	Sample2	Sample3
TP53	2.5	3.1	2.8
BRCA1	1.2	1.5	1.3
EGFR	4.5	4.2	4.8
```

**Submit expression data:**
```python
import requests

# Read TSV file
with open("expression_data.tsv", "r") as f:
    data = f.read()

response = requests.post(
    "https://reactome.org/AnalysisService/identifiers/",
    headers={"Content-Type": "text/plain"},
    data=data
)

result = response.json()
```

### Species Projection

Map identifiers to human pathways exclusively using the `/projection/` endpoint:

```python
response = requests.post(
    "https://reactome.org/AnalysisService/identifiers/projection/",
    headers={"Content-Type": "text/plain"},
    data=data
)
```

## Visualizing Results

Analysis results can be visualized in the Reactome Pathway Browser by constructing URLs with the analysis token:

```python
token = result["summary"]["token"]
pathway_id = "R-HSA-69278"
url = f"https://reactome.org/PathwayBrowser/#{pathway_id}&DTAB=AN&ANALYSIS={token}"
print(f"View results: {url}")
```

## Working with Analysis Tokens

- Analysis tokens are valid for **7 days**
- Tokens allow retrieval of previously computed results without re-submission
- Store tokens to access results across sessions
- Use `GET /token/{TOKEN}` endpoint to retrieve results

## Data Formats and Identifiers

### Supported Identifier Types

Reactome accepts various identifier formats:
- UniProt accessions (e.g., P04637)
- Gene symbols (e.g., TP53)
- Ensembl IDs (e.g., ENSG00000141510)
- EntrezGene IDs (e.g., 7157)
- ChEBI IDs for small molecules

The system automatically detects identifier types.

### Input Format Requirements

**For overrepresentation analysis:**
- Plain text list of identifiers (one per line)
- OR single column in TSV format

**For expression analysis:**
- TSV format with mandatory header row starting with "#"
- Column 1: identifiers
- Columns 2+: numeric expression values
- Use period (.) as decimal separator

### Output Format

All API responses return JSON containing:
- `pathways`: Array of enriched pathways with statistical metrics
- `summary`: Analysis metadata and token
- `entities`: Matched and unmapped identifiers
- Statistical values: pValue, FDR (false discovery rate)

## Helper Scripts

This skill includes `scripts/reactome_query.py`, a helper script for common Reactome operations:

```bash
# Query pathway information
python scripts/reactome_query.py query R-HSA-69278

# Perform overrepresentation analysis
python scripts/reactome_query.py analyze gene_list.txt

# Get database version
python scripts/reactome_query.py version
```

## Additional Resources

- **API Documentation**: https://reactome.org/dev
- **User Guide**: https://reactome.org/userguide
- **Documentation Portal**: https://reactome.org/documentation
- **Data Downloads**: https://reactome.org/download-data
- **reactome2py Docs**: https://reactome.github.io/reactome2py/

For comprehensive API endpoint documentation, see `references/api_reference.md` in this skill.

## Current Database Statistics (Version 94, September 2025)

- 2,825 human pathways
- 16,002 reactions
- 11,630 proteins
- 2,176 small molecules
- 1,070 drugs
- 41,373 literature references

© lifangda · MIT · lifangda/claude-plugins

Similar skills

All skills for Science and research →

reactome-database by other authors comes first.

reactome-database google-deepmind reactome-database connects Reactome services for gene list enrichment, identifier mapping, and pathway exports. Useful for running biological data queries inside coding agents. CX Codex +1 2,400installs reactome-skill official OpenAI Queries Reactome ContentService for biological pathways, reactions, and participants. Returns concise markdown summaries directly in Codex. CX Codex GP ChatGPT +1 14installs pubmed-database google-deepmind pubmed-database gives your agent a CLI into PubMed and PubMed Central: search papers, pull abstracts and full text, link publications to biological databases. CX Codex +1 3,000installs clinical-trials-database google-deepmind clinical-trials-database queries ClinicalTrials.gov via REST API v2 to search studies by condition, drug, status, or phase. Saves filtered study data directly to JSON. CX Codex +1 2,600installs database-lookup K-Dense-AI database-lookup queries 80 documented public database APIs with explicit filters, pagination, and provenance. It is useful when scientific or financial facts require reproducible citations. CX Codex +1 2,300installs Atlarium Habitat Database MCP ilgrafico79 Atlarium Habitat Database MCP — an MCP server providing structured biological data and calculators for aquariums, terrariums, and paludariums. Supplies species details, diagnostics, and dosing guidance. CX Codex +1 2,022installs openalex-database davila7 openalex-database connects Claude Code to the OpenAlex catalog to query papers, analyze citations, and track research trends. Works without an API key. CX Codex +1 59installs

From the same set2

Project sponsors

Companies that keep this analytics open