MCP Server Agenda

🚀 mcp-server-agenda Server Agenda Plugin

A server implementation for interacting with the Agenda app on macOS via Claude AI. This server provides features such as creating notes, managing projects, and opening existing notes in Claude using x-callback-urls.

🚀 Quick Start

This server implementation allows seamless interaction with the Agenda app on macOS through Claude AI. It offers a range of functions to enhance note - taking and project management.

✨ Features

• Create notes in Agenda 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 app. Supported operations include:

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

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

Configuration

Claude Desktop Configuration

To enable interaction with the 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"
        ]
    }
}

Replace /Users/your.username with your actual home directory path.

Requirements

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

  pip install uv
  

• Required Python packages (see requirements.txt)

Project Setup

This 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 via Claude AI"
requires-python = ">=3.7"
dependencies = [
    "flask",
    # Add other dependencies here
]

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

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

uv pip install -e .

🤝 Contribution

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 project is released under the MIT license. For more details, 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

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