Skip to main content
Glama
Sign In
alt-festival-mcp

alt-festival-mcp

by dkfmaekdnjfk
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

alt-festival-mcp

An MCP server that lets Claude (Desktop or Code) read live notes and transcripts from Alt — a real-time lecture/meeting transcription app — while a recording is in progress.

Built for conference use: keep Alt recording a talk, and ask Claude questions about it live, with Claude pulling only the newly-transcribed lines each time instead of re-reading the whole transcript.

How it works

Alt runs a local HTTP API on your machine (localhost, token-authenticated) that its own apps use internally. This is not officially documented for third-party use, so treat it as unofficial and subject to breaking on Alt updates. This server reads the port/token from Alt's own local config file (~/Library/Application Support/alt/storage-httpServer.json on macOS) at request time and exposes a few read-only operations over MCP. It never stores or transmits the token anywhere else.

Nothing about your Alt data leaves your machine — this server only talks to localhost.

Related MCP server: speak-to-me-mcp

Tools

Tool

Description

list_recent_notes

List recently created/updated Alt notes. The most recent one is usually whatever's being recorded right now.

search_notes

Search notes by title.

get_note_info

Get a single note's title, date, and status.

list_note_components

List what components a note has (transcript, memo, summary, recording, meeting_notes, ...) without fetching their content.

get_note_transcript

Fetch a note's live transcript. Pass sinceIndex (the totalEntries value from your previous call) to get only newly-transcribed lines — avoids re-sending the whole growing transcript on every call.

Requirements

  • Alt installed and running, with its local HTTP server enabled (this is the default).

  • macOS. The config path is currently hardcoded to Alt's macOS data directory; Windows/Linux paths aren't handled yet.

  • Node.js 20+.

Install

git clone https://github.com/dkfmaekdnjfk/alt-festival-mcp.git
cd alt-festival-mcp
npm install
npm run build

Register with Claude Code / Desktop

claude mcp add --scope user alt -- node /absolute/path/to/alt-festival-mcp/dist/index.js

Restart Claude Code/Desktop so it picks up the new server, then start a recording in Alt and ask Claude about it.

Example usage

"Alt에서 지금 녹음 중인 노트 열어서 지금까지 무슨 얘기했는지 알려줘" (Open whatever note Alt is currently recording and tell me what's been said so far)

Claude will call list_recent_notes to find the active note, then get_note_transcript to read it — and on later questions in the same conversation, pass sinceIndex so it only reads what's new.

Disclaimer

This project talks to an internal, undocumented local API that Alt happens to expose on your machine. It is not affiliated with or endorsed by Alt. It may stop working after an Alt update that changes the API shape.

Available Tools

5 tools
get_note_infoGet Alt note infoA

노트 ID로 제목, 날짜, 상태 등 기본 정보를 가져옵니다.

NameRequiredDescriptionDefault
noteIdYesAlt 노트 ID
get_note_transcriptGet Alt note transcript (incremental)A

노트의 실시간 전사를 가져옵니다. 강의를 계속 따라가려면 매번 sinceIndex에 지난 호출에서 받은 totalEntries 값을 넘겨서 새로 추가된 부분만 받으세요 — 이미 읽은 내용을 다시 보내지 않아 토큰을 절약합니다. 처음 호출할 때는 sinceIndex를 생략하거나 0으로 두세요.

NameRequiredDescriptionDefault
noteIdYesAlt 노트 ID
sinceIndexNo이전에 받은 totalEntries 값. 이 인덱스 이후의 새 구간만 반환됩니다.
list_note_componentsList Alt note componentsA

노트에 어떤 컴포넌트(transcript/memo/summary/recording/meeting_notes 등)가 있는지 요약해서 보여줍니다. 전사 본문이 아니라 목록만 필요할 때 사용하세요.

NameRequiredDescriptionDefault
noteIdYesAlt 노트 ID
list_recent_notesList recent Alt notesA

Alt(실시간 전사 도구)에 최근 생성/수정된 노트 목록을 반환합니다. 지금 녹음 중인 강의를 찾을 때 가장 먼저 호출하세요 — 보통 목록의 맨 앞이 현재 진행 중인 노트입니다.

NameRequiredDescriptionDefault

No parameters

search_notesSearch Alt notesB

제목 등으로 Alt 노트를 검색합니다.

NameRequiredDescriptionDefault
queryYes검색어

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 5 tool updatesv0.1.0
    • First observedget_note_info
    • First observedget_note_transcript
    • First observedlist_note_components
    • First observedlist_recent_notes
    • First observedsearch_notes
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4/5.0

Scored across 5 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: listing recent notes, searching, fetching note metadata, listing components, and retrieving transcripts. Even the two list-ish tools are clearly separated by recency vs. search.

Naming Consistency5/5

All tools use a consistent verb_noun snake_case pattern: list_, search_, get_. The verbs list vs. get also consistently distinguish collection vs. single-item operations.

Tool Count5/5

Five tools is well-scoped for a focused note/transcript retrieval server. Each tool serves a distinct step in the workflow of finding and reading lecture notes.

Completeness4/5

The core workflow of discovering a note and incrementally fetching its transcript is well covered. A minor gap is that non-transcript component types like memo or summary are listed but their actual content cannot be retrieved.

Maintenance

ActivityInactive
ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Related MCP Servers

  • youtube-transcript-mcp

    yunlinwu
    A
    license
    A
    quality
    D
    maintenance
    An MCP server that gives Claude access to YouTube video transcripts. Extract full transcripts, search for keywords with timestamps, and get direct YouTube links to matching moments.
    2
    1
    MIT

  • Personal Memory MCP Server

    tonyRaafat
    F
    license
    Not graded
    quality
    D
    maintenance
    A remote MCP server that gives Claude (and ChatGPT/Gemini) persistent read/write access to your own memory: books, games, projects, notes, and freeform facts.
    -