# ClassNotes MCP

ClassNotes MCP is a personal **Model Context Protocol (MCP) server** built in Python that connects Claude Desktop with Obsidian to automate class note management.

The project allows Claude to interact with a local Obsidian vault through MCP tools, enabling it to create, read, list, and search notes.

It can also process class recordings automatically using:

* **Faster-Whisper** for local speech-to-text transcription.
* **Qwen3:8B via Ollama** to convert transcripts into structured study notes.
* **Obsidian** to store the generated notes as Markdown files.
* **Claude Desktop** as the MCP host.

## Features

* Create notes directly in Obsidian.
* List notes by course.
* Read existing notes.
* Search concepts across the Obsidian vault.
* Convert class transcripts into structured notes.
* Process audio recordings and generate study notes automatically.
* Generate sections such as summaries, key concepts, review points, and Active Recall questions.

## Workflow

```text
Class recording
      ↓
Faster-Whisper
      ↓
Transcription
      ↓
Qwen3:8B (Ollama)
      ↓
Structured notes
      ↓
ClassNotes MCP
      ↓
Obsidian
```

Claude Desktop communicates with the Python server through MCP and can invoke the available tools according to the user's request.

## Main Technologies

* Python 3.12
* Model Context Protocol (MCP)
* Claude Desktop
* Obsidian
* Faster-Whisper
* Ollama
* Qwen3:8B

## Installation

Create and activate a virtual environment:

```powershell
py -3.12 -m venv .venv
.\.venv\Scripts\Activate.ps1
```

Install the dependencies:

```powershell
pip install -r requirements.txt
```

Create a `.env` file with the path to your Obsidian vault:

```env
OBSIDIAN_VAULT="C:/path/to/your/Obsidian Vault"
```

Make sure Ollama is running and that `qwen3:8b` is available:

```powershell
ollama list
```

## Run

The MCP server can be tested with:

```powershell
python server.py
```

or through MCP Inspector:

```powershell
mcp dev server.py
```

## Purpose

The goal of ClassNotes MCP is to reduce the time required to manually transcribe, summarize, and organize class recordings, while keeping the workflow local and using free/open-source tools whenever possible.