mcp-server-agenda logo

mcp-server-agenda

by alexgoller

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

View on GitHub

Last updated: N/A

What is mcp-server-agenda?

mcp-server-agenda is a server that allows you to interact with the Agenda app on macOS through Claude AI. It leverages Agenda's x-callback-url scheme to enable actions like creating notes, managing projects, and opening existing notes.

How to use mcp-server-agenda?

To use this server, you need to clone the repository, configure Claude Desktop to interact with the server by adding the appropriate configuration to the claude_desktop_config.json file, install the required Python packages using uv, and set up a pyproject.toml file. Then, you can use Claude AI to trigger actions within Agenda through the server.

Key features of mcp-server-agenda

  • Create notes in Agenda with various options (title, text, dates, templates, etc.)

  • Create and manage projects within Agenda

  • Open existing notes directly from Claude

  • Full support for Agenda's x-callback-url scheme

Use cases of mcp-server-agenda

  • Automating note creation in Agenda using AI

  • Managing projects in Agenda through voice commands or AI prompts

  • Quickly opening specific notes in Agenda based on AI-driven search or context

  • Integrating Agenda with other AI-powered workflows

FAQ from mcp-server-agenda

What is Agenda?

Agenda is a date-focused note taking application for macOS, iPadOS, and iOS.

What is x-callback-url?

x-callback-url is a URL scheme that allows applications to communicate with each other and trigger actions.

How do I configure Claude Desktop to use this server?

You need to add a configuration block to your Claude desktop config file (claude_desktop_config.json) specifying the command and arguments to run the server.

What are the requirements for running this server?

You need macOS, Python 3.7+, the Agenda app installed, uv, and the required Python packages.

Where can I find more information about Agenda's x-callback-url scheme?

You can find more information on the Agenda community forums.