mcp-server-agenda

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.

What actions does the server support?

It supports create-note, open-note, and create-project via Agenda’s x-callback-url scheme.

How do I install mcp-server-agenda?

Clone the repository, create a pyproject.toml file with required dependencies, then run uv pip install -e . from the project root.