Agenda App
About
Integrates with Agenda note-taking app on macOS to enable creating notes, managing projects, and opening existing notes using x-callback-urls.
Details
- Repository
- alexgoller/mcp-server-agenda
Explore
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Agenda AppCommand (node, npx, python, etc.)uvArguments-
Argument 1
--directory -
Argument 2
/Users/your.username/git/mcp-server-agenda -
Argument 3
run -
Argument 4
mcp-server-agenda
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Clone the repository:
git clone https://github.com/yourusername/mcp-server-agenda.git
cd mcp-server-agenda
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.
The project requires a pyproject.toml file for uv to work properly. Create one in the root directory:
```toml
[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",
create-note
Create a new note in Agenda with various options such as title, text, dates, and templates.
open-note
Open an existing note in Agenda directly from the server.
create-project
Create and manage a new project within Agenda.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"agenda app": {
"cwd": "",
"env": {},
"args": [
"--directory",
"/Users/your.username/git/mcp-server-agenda",
"run",
"mcp-server-agenda"
],
"shell": false,
"command": "uv"
}
}
}Linux
{
"env": [],
"args": [
"-y",
"@highlight/mcp-server"
],
"command": "npx"
}Macos
{
"cwd": "",
"env": [],
"args": [
"--directory",
"/Users/your.username/git/mcp-server-agenda",
"run",
"mcp-server-agenda"
],
"shell": false,
"command": "uv"
}Windows
{
"env": [],
"args": [
"/c",
"npx",
"-y",
"@highlight/mcp-server"
],
"command": "cmd"
}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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
