Alexgoller MCP Server Agenda

🚀 mcp-server-agenda Server Implementation

A server implementation that interacts with the Agenda application on macOS through Claude AI. This server provides functions such as creating notes, managing projects, and opening existing notes using x-callback-urls.

🚀 Quick Start

The mcp-server-agenda is a server that enables interaction with the Agenda application on macOS via Claude AI. It allows users to create notes, manage projects, and open existing notes conveniently.

✨ Features

• Create Agenda notes with various options (title, text, date, template, etc.).
• Create and manage projects in Agenda.
• Open existing notes directly from Claude.
• Fully support 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 Examples

X-Callback-URL Integration

This server uses Agenda's x-callback-url scheme to interact with the application. Supported operations include:

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

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

Configuration Settings

Claude Desktop Configuration

To enable interaction with this server in Claude, add the following configuration to your Claude desktop configuration 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"
        ]
    }
}

Please replace /Users/your.username with your actual user directory path.

Project Requirements

• macOS operating system
• Python version 3.7+
• Agenda application installed
• uv - A modern Python package installer and resolver

pip install uv

• Necessary Python libraries (see requirements.txt)

Project Setup

This project requires a pyproject.toml file to run properly. Create a file with the following content in the root directory:

[project]
name = "mcp-server-agenda"
version = "0.1.0"
description = "A server implementation that interacts with the Agenda application on macOS through Claude AI"
requires-python = ">=3.7"
dependencies = [
    "flask",
    # Add other dependencies here
]

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

After creating the pyproject.toml file, you can install the project in development mode using the following command:

uv pip install -e .

🤝 Contribution Guidelines

1. Fork the repository.
2. Create a 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 work is released under the MIT License. For details, please see the LICENSE file.

🙏 Acknowledgments

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

🛠️ Support

If you need help, please open an issue in the GitHub repository or contact the maintainers.