# OmniContext

Connect Claude to your life — without touching a terminal.

<!-- INSERTA AQUÍ EL GIF DE DEMOSTRACIÓN -->

![Status](https://img.shields.io/badge/status-MVP-6366f1)
![Node](https://img.shields.io/badge/node-%3E%3D20-339933?logo=node.js&logoColor=white)
![Protocol](https://img.shields.io/badge/protocol-MCP-000000)
[![License](https://img.shields.io/badge/license-MIT-yellow)](LICENSE)

OmniContext is a local MCP server for Claude Desktop that connects Claude to the tools you already use — Notion and YouTube today, more on the way. Install it as a one-click extension, no terminal or API dashboard required.

```
You:    Summarize this video for me: youtube.com/watch?v=xxxxxxxxxxx
Claude: [reads the transcript through OmniContext and replies instantly]

You:    What does my Notion page "Q3 Roadmap" say about launch dates?
Claude: [searches your Notion, opens the page, answers from its content]
```

---

## Features

- **Notion, without the copy-pasting** — search page titles and pull full page content as clean markdown, right from the conversation.
- **YouTube videos, the moment you paste the link** — Claude reads the transcript and can summarize, analyze, or answer questions about it instantly.
- **Clean transcript exports** — when you want the raw text (for notes, research, or another tool), OmniContext saves it as a tidy `.md` file instead of dumping it into the chat.

More integrations are on the way — see the [Roadmap](#roadmap).

---

## Installation

No code, no terminal, no API dashboard.

1. Download the latest `omnicontext.mcpb` from the [Releases](../../releases) tab.
2. Open Claude Desktop → the menu (☰) → `File → Settings → Extensions`.
3. Click Advanced settings then scroll down to *Install Extension…* and select it.
4. Using Notion? Paste your integration token into the form Claude Desktop shows you. That's the entire setup.
5. Try it in a chat:
   - "What's this YouTube video about: `<link>`"
   - "Read my Notion page: `<link>`"

Note: your Notion token is stored encrypted by your OS (Keychain on macOS, Credential Manager on Windows) — never in a plain text file. If you don't need Notion, skip it; the YouTube tools work with zero setup.

---

## Development

For running the server from source, contributing, or wiring it into Claude Code instead of Claude Desktop.

```bash
git clone <your-repo-url>
cd omnicontext
npm install
npm run build     # compiles TypeScript -> dist/
npm test          # full suite, incl. live smoke tests
npm run pack      # builds omnicontext.mcpb locally
```

Register it with Claude Code:

```bash
claude mcp add --transport stdio omnicontext \
  --env NOTION_TOKEN=your_notion_token \
  -- node /absolute/path/to/omnicontext/dist/index.js
```

Run it directly during development:

```bash
npm run dev
```

Debug tool calls with the official [MCP Inspector](https://github.com/modelcontextprotocol/inspector):

```bash
npx @modelcontextprotocol/inspector node dist/index.js
```

### Tools reference

| Tool | What it does |
|---|---|
| `notion_get_page` | Reads a Notion page (URL or ID) and returns it as markdown |
| `notion_search` | Searches page titles across everything shared with the integration |
| `youtube_get_transcript` | Fetches a YouTube video's transcript as plain text, for in-chat analysis |
| `youtube_save_transcript` | Saves a video's full transcript to a local `.md` file |

---

## Roadmap

OmniContext is an early MVP — the foundation is in place, and the integrations list is just getting started.

- [x] YouTube transcripts (in-chat + file export)
- [x] Notion (internal token, read-only)
- [x] One-click `.mcpb` packaging for Claude Desktop
- [ ] Notion OAuth — one-click connect, no more manual tokens or sharing pages by hand
- [ ] Discord integration
- [ ] Telegram integration
- [ ] More integrations, one context source at a time

---

## Privacy & security

OmniContext runs entirely on your machine. It talks directly to Notion's and YouTube's own APIs — there is no OmniContext backend, no analytics, and no middleman server that sees your data.

---

## Contributing

Issues and pull requests are welcome. If you're adding a new integration, follow the existing pattern in `src/integrations/<name>/` — each one is self-contained and registers its own tools without touching the core server.

## Support

Found a bug or want to request an integration? [Open an issue](../../issues).

---

## License

[MIT](LICENSE) — free to use, modify, and self-host.

---

Built on the [Model Context Protocol](https://modelcontextprotocol.io).