Skip to main content
Glama
Sign In
meetings-mcp

meetings-mcp

by aminafara123
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

meetings-mcp

An MCP server over the output of my meeting-transcription-pipeline. It takes the finished transcripts (Whisper text, speaker labeled with pyannote) and exposes them as tools any MCP-capable AI client can call.

The pipeline turns a recording into a long text file. Thats useful, but nobody rereads two hours of meeting. With this server a model can list the meetings, page through one, or search all of them for a topic and come back with the exact timestamp.

Tools

Tool

What it does

list_meetings()

Every transcript with its id, length, turn count and speaker count

get_transcript(meeting, start)

One page of 25 speaker turns, with the start value for the next page

search_transcripts(query)

Case-insensitive search across all meetings, with meeting id, timestamp and turn number per hit

Related MCP server: LogicNotes MCP Server

Setup

pipx install meetings-mcp

uvx meetings-mcp works too if you prefer no install. Hacking on a clone instead:

python3 -m venv .venv
.venv/bin/pip install mcp

Wire it into Claude Code:

claude mcp add meetings -- meetings-mcp

Running from a clone, point it at the venv instead:

claude mcp add meetings -- /path/to/meetings-mcp/.venv/bin/python /path/to/meetings-mcp/meetings_mcp.py

Demo

What it looks like from Claude Code:

> did we talk about the renewal in any recent meeting?

⏺ meetings · list_meetings()

  2 meeting(s):
  - 2026-09-21-vendor-review: 00:41:09, 4 turns, 3 speaker(s)
  - 2026-09-24-weekly-sync: 00:18:47, 3 turns, 2 speaker(s)

⏺ meetings · search_transcripts("renewal")

  3 match(es) for 'renewal':

  [2026-09-21-vendor-review @ 00:03:12, turn 1] Speaker 2: The renewal quote came in higher, about fifteen percent.
  [2026-09-21-vendor-review @ 00:07:40, turn 2] Speaker 1: Then we push back on the renewal before Friday.
  [2026-09-24-weekly-sync @ 00:12:30, turn 1] Speaker 2: The renewal is signed, same price as last year.

⏺ Yes, twice. In the vendor review the quote came in about 15% higher
  and the plan was to push back. By the weekly sync it was signed at
  last year's price.

The meetings above are demo data. The format is exactly what the server returns.

Design notes

  • Read-only by construction. Every tool reads text files, nothing writes. The transcripts stay on my machine and the model only sees what a tool returns.

  • Pseudonyms at the boundary. Speaker labels become Speaker 1, Speaker 2 and so on by first appearance, even when the source file has real names. Emails, phone numbers, home paths and long tokens get replaced before anything crosses the protocol.

  • Paged, not dumped. A two hour meeting is hundreds of turns. The server hands it over 25 turns at a time so a model reads what it needs instead of flooding its context.

Honest notes

  • It reads the pipeline's transcripts/ folder, one .speakers.txt per meeting, falling back to the raw Whisper .txt when diarization hasnt run. You need to run the pipeline first. The default path is my local copy. Point MEETINGS_DATA_DIR at your own data folder.

  • The redaction is pattern based. It catches speaker labels, emails, phone numbers and paths, but a name spoken inside a sentence still comes through as said.

  • Search is a plain substring match, so an Arabic query has to match the spelling Whisper produced.

  • The logic is tested against synthetic transcripts in test_server.py. Run python test_server.py.

About

Al Amin Bashir Afara, Dubai · github.com/aminafara123 · linkedin.com/in/aminafara

Available Tools

3 tools
get_transcriptA
Read-onlyIdempotent

One page of a meeting transcript, 25 turns from turn number start. Call again with the start value it suggests to read on.

Inputs: meeting (required), start. Returns: result

list_meetingsA
Read-onlyIdempotent

Every transcribed meeting with its id, length, turn count and number of distinct speakers. Use the id with get_transcript.

Inputs: no named parameters. Returns: result

search_transcriptsA
Read-onlyIdempotent

Case-insensitive substring search across every transcript. Returns each matching turn with its meeting id and timestamp, text capped.

Inputs: query (required). Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    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 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: list_meetings enumerates meetings, get_transcript fetches paginated transcript content for a known meeting id, and search_transcripts performs a global substring search. There is no overlap in resource or action, so selection errors are unlikely.

    Naming Consistency5/5

    All three names follow a consistent snake_case verb_noun pattern (list_meetings, get_transcript, search_transcripts). The singular/plural difference reflects the object cardinality well and does not break the convention.

    Tool Count4/5

    Three tools is on the low end but well-scoped for a read-only transcript server: listing, reading paginated content, and searching. No functionality feels redundant or missing enough to warrant extra tools.

    Completeness4/5

    The read-only surface covers the core workflows: discover meetings, read a transcript, and search across all transcripts. Minor gaps exist, such as filtering meetings by date or retrieving per-speaker data, but agents can work around these using the provided tools.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • gilbert-mcp

      HugoF1234
      A
      license
      A
      quality
      D
      maintenance
      Read-only access to your Gilbert meetings, transcripts and summaries over MCP — list, search, and fetch transcripts and summaries.
      5
      69 npm
      1
      MIT

    • Walkie for MCP

      adamperlis
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables MCP clients to search and read recorded meeting data, including transcripts, notes, action items, and participants, from Walkie's local database.
      1
      MIT