Agenda

Provides an MCP interface to create and open Agenda notes and projects via x-callback-url integration.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run an MCP server that talks to Agenda on macOS using Claude AI to create notes, manage projects, and open notes directly in Agenda via x-callback-urls. This server runs locally through uv and exposes actions you can trigger from your MCP client.

How to use

You interact with the Agenda MCP server from your MCP client by starting the local server process and then issuing MCP requests that map to Agenda actions. The server understands actions such as creating a note, opening a note, and creating a project in Agenda using Agenda’s x-callback-url scheme. Use the client’s standard request flow to target the local server process and supply the necessary parameters (title, text, dates, templates, etc.) for notes, or the project name for projects.

How to install

Prerequisites you need before starting:

macOS with Agenda installed

Python 3.7 or newer

uv package manager

A working Internet connection to install dependencies

Step 1: Install the uv tool for Python package resolution

pip install uv

Step 2: Prepare the project environment by installing dependencies and enabling development mode

# From the project root
uv pip install -e .

Step 3: Run the MCP server locally using uv. The server is started with the command shown in the configuration snippet

uv run mcp-server-agenda

Step 4: (Optional) If you need to configure Claude Desktop to reach the local server, add the following to your Claude desktop configuration file at the path shown

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

Available tools

create_note

Create a new note in Agenda with specified title, text, dates, and templates using the Agenda x-callback-url scheme.

open_note

Open an existing Agenda note by providing the note identifier or URL using Agenda's x-callback-url scheme.

create_project

Create a new project within Agenda and optionally set associated notes or properties via the x-callback-url interface.