mcp-server-agenda

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.

Features

• 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

Installation

1. Clone the repository:

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

Usage

X-Callback-URL Integration

This server utilizes Agenda's x-callback-url scheme to interact with the app. Supported actions include:

• `create-note`
• `open-note`
• `create-project`

For more information about Agenda's x-callback-url scheme, visit their documentation.

Configuration

Claude Desktop Configuration

To enable Claude to interact with the server, add the following configuration to your Claude desktop config file located at `$HOME/Library/Application Support/Claude/claude_desktop_config.json`:

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

Make sure to replace `/Users/your.username` with your actual home directory path.

Requirements

• macOS
• Python 3.7+
• Agenda app installed
• uv - Modern Python package installer and resolver

pip install uv

• Required Python packages (see requirements.txt)

Project Setup

The project requires a `pyproject.toml` file for uv to work properly. Create one in the root directory:

[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"

After setting up the pyproject.toml, you can install the project in development mode using:

uv pip install -e .

Contributing

1. Fork the repository

2. Create your feature branch (`git checkout -b feature/amazing-feature`)

3. Commit your changes (`git commit -m 'Add some amazing feature'`)

4. Push to the branch (`git push origin feature/amazing-feature`)

5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Thanks to the Agenda team for providing x-callback-url support
• Inspired by the need for AI-driven note management

Support

For support, please open an issue in the GitHub repository or contact the maintainers.