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

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:

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

Install the dependencies:

pip install -r requirements.txt

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

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

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

ollama list

Run

The MCP server can be tested with:

python server.py

or through MCP Inspector:

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.