Agenda MCP Server

Overview

The mcp‑server‑agenda is a lightweight Model Context Protocol (MCP) server that bridges the macOS Agenda application with Claude AI. By exposing a set of tools over MCP, developers can let an AI assistant create, update, and retrieve Agenda notes and projects directly from conversational prompts. This solves the common pain point of manually switching between a note‑taking app and an AI interface, streamlining workflows that require instant context creation or retrieval.

At its core, the server implements Agenda’s x‑callback‑url scheme. When Claude issues a command—such as “create a new note titled ‘Team Sync’ with the agenda for tomorrow”—the server translates that intent into a properly encoded x‑callback URL and triggers the Agenda app. Supported actions include , , and , each accepting a rich set of parameters like title, body text, dates, templates, and project associations. This tight coupling means that the AI can not only generate content but also persist it in a structured, searchable format without leaving the conversation.

Key capabilities of the server are:

• Note creation with customizable metadata (title, body, dates, templates) that maps directly to Agenda’s fields.
• Project management allowing users to create or modify projects and link notes to them on the fly.
• Direct opening of existing notes, enabling quick reference or editing from Claude’s interface.
• Full support for the entire x‑callback‑url protocol, ensuring compatibility with any advanced Agenda features that are exposed through URLs.

In practice, this MCP server is invaluable for teams that rely on Agenda for task and project tracking. A product manager could ask Claude to “draft a meeting agenda for next week’s sprint review” and have the note appear instantly in Agenda, ready for review or sharing. A researcher could request Claude to “summarize the latest meeting minutes” and have that summary stored as a new note, preserving context for future queries. Because the server operates over MCP, it integrates seamlessly into any AI workflow that already consumes MCP tools—whether that’s a custom Claude desktop setup, an in‑house chatbot, or a third‑party integration.

What sets mcp‑server‑agenda apart is its minimal footprint and native macOS focus. It requires only Python 3.7+, the Agenda app, and a single MCP configuration entry in Claude’s desktop config file. Developers can spin it up locally with uv, keeping dependencies isolated and reproducible. The use of x‑callback URLs guarantees that every action is performed by the official Agenda client, preserving data integrity and leveraging built‑in features like notifications or automatic syncing. For teams that value rapid, AI‑driven note creation and project organization on macOS, this server offers a clean, declarative bridge that keeps the conversation—and the agenda—moving forward.