What is Mcp Server Agenda

mcp-server-agenda is a server implementation designed to interface with the Agenda note-taking application on macOS using the x-callback-url scheme, allowing users to create and manage notes and projects seamlessly.

Use cases

Use cases for mcp-server-agenda include creating structured notes for meetings, managing project timelines, and quickly accessing existing notes during discussions, making it ideal for professionals and teams looking to streamline their documentation processes.

How to use

To use mcp-server-agenda, clone the repository, configure the Claude desktop settings to interact with the server, and utilize the x-callback-url actions such as create-note, open-note, and create-project to manage your notes and projects in Agenda.

Key features

Key features include the ability to create notes with various options (title, text, dates, templates), manage projects within Agenda, and directly open existing notes from Claude, all while fully supporting Agenda’s x-callback-url scheme.

Where to use

mcp-server-agenda is primarily used in personal productivity and project management contexts, particularly for users of the Agenda app on macOS who seek to enhance their note-taking and project organization workflows.

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.