https://github.com/peter-fusek/oncofiles
Medical records scattered across Gmail and Google Drive? Oncofiles reads, organizes, and makes them available through AI. For cancer patients and caregivers. Works with Claude & ChatGPT.
https://github.com/peter-fusek/oncofiles
ai anthropic cancer chatgpt claude document-management european-health-data-space fastmcp files-api health healthcare mcp mcp-server medical medical-records oncology patient-data python slovakia turso
Last synced: 3 months ago
JSON representation
Medical records scattered across Gmail and Google Drive? Oncofiles reads, organizes, and makes them available through AI. For cancer patients and caregivers. Works with Claude & ChatGPT.
- Host: GitHub
- URL: https://github.com/peter-fusek/oncofiles
- Owner: peter-fusek
- License: mit
- Created: 2026-03-02T22:02:25.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-04-29T13:15:38.000Z (3 months ago)
- Last Synced: 2026-04-29T13:39:54.607Z (3 months ago)
- Topics: ai, anthropic, cancer, chatgpt, claude, document-management, european-health-data-space, fastmcp, files-api, health, healthcare, mcp, mcp-server, medical, medical-records, oncology, patient-data, python, slovakia, turso
- Language: Python
- Homepage: https://oncofiles.com
- Size: 29.9 MB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 62
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-medical-ai-skills - oncofiles - | ๐ข Active |  | Cancer-care MCP server that organizes Gmail, Google Drive, and Calendar medical records for patients and caregivers. Multi-patient isolation, OAuth setup, demo dashboard, and 600+ passing tests. | (Medical MCP Servers)
- awesome-healthcare-mcp-servers - Oncofiles - AI-powered medical document management for cancer patients and caregivers with OCR, lab value tracking with reference ranges, pre-cycle safety checks, and PubMed/ClinicalTrials.gov integration across 76 tools (`L4` `B` `Python`). (Clinical Decision Support / Clinical Validity Score)
README
# oncofiles
[]()
[]()
[]()
[](https://claude.ai)
[](https://chatgpt.com)
[](LICENSE)
Your medical records are scattered across Gmail, Google Drive, and Calendar. Oncofiles reads everything, organizes it, and makes it available through AI โ so you can ask about your health naturally in Claude or ChatGPT.
**[oncofiles.com](https://oncofiles.com)** | [Demo Dashboard](https://oncofiles.com/demo) | [Privacy Policy](https://oncofiles.com/privacy)
## What is this?
Oncofiles is an [MCP server](https://modelcontextprotocol.io/) built for cancer patients and their caregivers. It connects to your Google Drive, Gmail, and Calendar, reads all your medical documents (lab results, CT scans, pathology reports, prescriptions), and makes them accessible through any AI chat โ Claude, ChatGPT, or any MCP client.
**Built from real need:** Created by a caregiver managing his wife's cancer treatment. Hundreds of documents, dozens of doctors, constantly changing lab results. Oncofiles organizes the chaos so you can focus on treatment, not on finding papers.
**Sister project:** [Oncoteam](https://oncofiles.com/oncoteam) โ an AI agent that analyzes your Oncofiles data: tracks lab trends, searches clinical trials, and prepares questions for your oncologist.
**Your data, your control:** Everything stays in your Google Drive. No third-party data processing. Disconnect anytime โ your files are always yours.
## Multi-Patient Support (v4.0+)
Oncofiles supports multiple patients on a single instance. Each patient gets:
- **Full data isolation** โ documents, labs, treatment events, emails, and calendar entries are scoped to the patient
- **Separate bearer tokens** โ each patient (or caregiver) gets their own `onco_*` token
- **Per-patient OAuth** โ Google Drive, Gmail, and Calendar are authorized per patient
- **Dashboard patient selector** โ switch between patients in the web dashboard
### Onboarding a new patient
1. **Dashboard wizard:** Open the dashboard, click "+ New Patient", and follow the 4-step wizard
2. **API:** `POST /api/patients` with `{patient_id, display_name}` โ returns a bearer token
3. **Connect GDrive:** Visit `/oauth/authorize/drive?patient_id=X` to authorize document sync
4. **Trigger first sync:** `POST /api/sync-trigger` with `{patient_id}` to import documents
## Features
- **76 MCP tools** across 14 modules for comprehensive medical data management
- **14 document categories** โ labs, pathology, imaging, genetics, surgery, consultation, prescriptions, and more
- **Lab value tracking** โ store values, track trends, pre-cycle safety checks for chemo protocols
- **Google Drive sync** โ bidirectional sync with automatic OCR companion files
- **Gmail & Calendar scanning** โ medical emails and appointments are auto-detected and classified
- **Clinical research** โ search PubMed and ClinicalTrials.gov, log research decisions
- **Treatment timeline** โ track chemo cycles, surgeries, and other treatment events
- **Document versioning** โ track document revisions with full history
- **AI-powered metadata** โ automatic summaries, tags, and structured data extraction
- **Audit logging** โ every tool call is logged for accountability
## Architecture
```
โโโโโโโโโโโโโโโโโโโ MCP Protocol โโโโโโโโโโโโโโโโ
โ Claude / GPT โโโโโโโโโโโโโโโโโโโโโโโบ โ Oncofiles โ
โ (AI Assistant) โ streamable-http โ MCP Server โ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโฌโโโโโโโโ
โ
โโโโโโโโโโโโโโโผโโโโโโโโโโโโโโ
โ โ โ
โโโโโโโผโโโโโโ โโโโโโผโโโโโ โโโโโโโผโโโโโโ
โ SQLite / โ โ Google โ โ Anthropic โ
โ Turso โ โ Drive โ โ Files API โ
โโโโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโโโ
```
**Stack:** Python 3.12+ ยท FastMCP 3.1 ยท Pydantic ยท SQLite/Turso ยท Railway
## Quick start
```bash
# Clone and install
git clone https://github.com/peter-fusek/oncofiles.git
cd oncofiles
uv sync --extra dev
# Run locally (stdio mode for Claude Desktop)
uv run oncofiles-mcp
# Run tests
uv run pytest
# Lint
uv run ruff check
```
### Environment variables
```bash
# Required
DATABASE_PATH=data/oncofiles.db
# Optional โ cloud database
TURSO_DATABASE_URL=libsql://...
TURSO_AUTH_TOKEN=...
# Optional โ Google Drive sync
GOOGLE_DRIVE_FOLDER_ID=...
GOOGLE_OAUTH_CLIENT_ID=...
GOOGLE_OAUTH_CLIENT_SECRET=...
# Optional โ remote access
MCP_TRANSPORT=streamable-http # default: stdio
MCP_HOST=0.0.0.0
MCP_PORT=8080
MCP_BEARER_TOKEN=...
```
### Connect to Claude Desktop
Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
```json
{
"mcpServers": {
"oncofiles": {
"command": "uv",
"args": ["run", "oncofiles-mcp"],
"cwd": "/path/to/oncofiles"
}
}
}
```
### Connect to ChatGPT
Oncofiles works with ChatGPT's MCP integration (Developer Mode). Point ChatGPT to your instance's `/mcp` endpoint with a bearer token.
### Deploy to Railway
The included `Dockerfile` is ready for Railway deployment:
1. Push to GitHub
2. Connect repo in Railway
3. Set environment variables
4. Railway auto-deploys on push
Live instance: [oncofiles.com](https://oncofiles.com)
## Project structure
```
src/oncofiles/
โโโ server.py # FastMCP server, auth, routes, scheduler
โโโ database/ # Mixin-based DB layer (SQLite/Turso)
โโโ tools/ # 14 tool modules (76 tools)
โ โโโ documents.py # CRUD, search, view, versioning
โ โโโ lab_trends.py # Lab values, trends, safety checks
โ โโโ clinical.py # Treatment events, research log
โ โโโ research.py # PubMed, ClinicalTrials.gov search
โ โโโ ...
โโโ sync.py # Bidirectional Google Drive sync
โโโ gmail_sync.py # Medical email detection and import
โโโ calendar_sync.py # Calendar event classification
โโโ enhance.py # AI metadata extraction (Haiku)
โโโ patient_middleware.py # Per-patient token โ context resolution
โโโ patient_context.py # Patient clinical profile
โโโ models.py # Pydantic models
```
## MCP Registry
Listed on the [MCP Registry](https://registry.modelcontextprotocol.io/) as `io.github.peter-fusek/oncofiles`.
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
## License
[MIT](LICENSE)
---
## Who's Behind This
### The People
**Peter Fusek** โ CEO & Founder
Serial entrepreneur and AI strategist. 4 years at Tatra banka. Co-founded marketlocator (exit to Deutsche Telekom). Advisor to VรB Bank CEO. 18+ years building technology products.
Built Oncofiles from personal need โ managing his wife's cancer treatment across hundreds of documents, dozens of doctors, and constantly changing lab results.
[LinkedIn](https://www.linkedin.com/in/peterfusek/) ยท peter.fusek@instarea.com
**Peter ฤapkoviฤ** โ CTO & Co-founder
Senior IT architect with 20+ years in enterprise banking (VรB). Expert in .NET, Python, SQL, and systems architecture. Led architecture across all Instarea products.
Architecture, development, operations โ everything under one roof.
[LinkedIn](https://www.linkedin.com/in/peter-capkovic/)
### The Company
**[Instarea](https://www.instarea.com)** โ 18 years, 23 products shipped. From telecom analytics and enterprise clients (Callinspector) to mobile-first fintech (InventButton), big data exits (marketlocator โ Deutsche Telekom), IoT platforms, and AI-first products (PulseShape, ReplicaCity, HomeGrif).
Oncofiles and [Oncoteam](https://github.com/peter-fusek/oncoteam) are Instarea's latest โ built with the same engineering discipline that delivered enterprise-grade products for banking, telecom, and data industries.
10+ verified, synchronized team members available across front-end, back-end, integration, data science, UX/UI, marketing, and cloud ops.
> *"We take it personally, with our own faces, like family and at work."*
Built by [Instarea](https://www.instarea.com) | Aligned with [EHDS](https://health.ec.europa.eu/ehealth-digital-health-and-care/european-health-data-space_en) principles