home / mcp / agenda mcp server

Agenda MCP Server

Provides a Python-based MCP server to interact with Agenda on macOS via x-callback-urls for creating and opening notes and managing projects.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "alexgoller-mcp-server-agenda": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/your.username/git/mcp-server-agenda",
        "run",
        "mcp-server-agenda"
      ]
    }
  }
}

You can run a dedicated MCP server that lets you manage Agenda on macOS through Claude AI. It exposes actions like creating notes, organizing projects, and opening existing notes using Agenda’s x-callback-url scheme, enabling automated workflows and AI-assisted note management.

How to use

Install and run the server on your Mac, then connect an MCP client to perform actions against Agenda. You can create notes with rich options, create and manage projects, or open a note directly from Claude using the supported x-callback-url actions. Use the MCP URL/command path configured for your environment to start the server, then issue actions like create-note, open-note, and create-project through your client.

How to install

Prerequisites you need to meet before installing the server:

macOS is required
Python 3.7 or newer
Agenda app installed
uv package manager (to run the server)

Install the uv tool and set up the project directory as shown in the configuration example.

pip install uv

Next, clone the project and navigate into the directory to prepare for running the server.

git clone https://github.com/yourusername/mcp-server-agenda.git
cd mcp-server-agenda

Set up the Python project configuration as shown in the example snippet and install development dependencies. You will also set the project name and dependencies in a pyproject.toml file.

# Example pyproject.toml configuration (needs to be created at project root)
[project]
name = "mcp-server-agenda"
version = "0.1.0"
description = "A server implementation for interacting with the Agenda app on macOS through Claude AI"
requires-python = ">=3.7"
dependencies = [
    "flask",
    # Add other dependencies here
]

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"