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
- Author
- alexgoller
- Repository
- alexgoller/mcp-server-agenda
- GitHub stars
- 2
- Downloads
- 327
- Categories
- Productivity, Design, Developer Tools, AI, Frontend, Project Management, Automation, Other
- Tags
- #integration
Jump to
- 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
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.
