mcp-server-agenda

Name: mcp-server-agenda
Author: alexgoller

@alexgoller

Repository

About mcp-server-agenda

A model context protocol server to interface the agenda note taking software using x-callback-url

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-agenda": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "-e",
        "."
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is mcp-server-agenda?

mcp-server-agenda is a server implementation for interacting with the Agenda app on macOS through Claude AI. It provides tools to create notes, manage projects, and open existing notes in Agenda using x-callback-urls.

How to use mcp-server-agenda?

Clone the repository, install dependencies with uv, and configure Claude Desktop by adding the command and args to claude_desktop_config.json. Once set up, Claude can invoke actions such as create-note, open-note, and create-project.

Key features of mcp-server-agenda

Create notes with various options (title, text, dates, templates)
Create and manage projects within Agenda
Open existing notes directly from Claude
Full support for Agenda’s x-callback-url scheme
Requires macOS, Python 3.7+, and the Agenda app

Use cases of mcp-server-agenda

AI-assisted note creation and project management in Agenda
Quickly open existing Agenda notes through Claude conversations
Automate note-taking tasks using natural language commands

FAQ from mcp-server-agenda

What are the system requirements?

macOS, Python 3.7+, the Agenda app installed, and the uv Python package installer.

How do I configure Claude Desktop to use this server?

Add the following JSON to $HOME/Library/Application Support/Claude/claude_desktop_config.json: {"mcp-server-agenda": {"command": "uv", "args": ["--directory", "/path/to/your/repo", "run", "mcp-server-agenda"]}}. Replace /path/to/your/repo with your actual home directory path.