mcp-server-agenda

@alexgoller

About mcp-server-agenda

A model context protocol server to interface the agenda note taking software using x-callback-url

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-agenda": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "-e",
        "."
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is mcp-server-agenda?

mcp-server-agenda is a server implementation for interacting with the Agenda app on macOS through Claude AI. It provides tools to create notes, manage projects, and open existing notes in Agenda using x-callback-urls.

How to use mcp-server-agenda?

Clone the repository, install dependencies with uv, and configure Claude Desktop by adding the command and args to claude_desktop_config.json. Once set up, Claude can invoke actions such as create-note, open-note, and create-project.

Key features of mcp-server-agenda

Create notes with various options (title, text, dates, templates)
Create and manage projects within Agenda
Open existing notes directly from Claude
Full support for Agenda’s x-callback-url scheme
Requires macOS, Python 3.7+, and the Agenda app

Use cases of mcp-server-agenda

AI-assisted note creation and project management in Agenda
Quickly open existing Agenda notes through Claude conversations
Automate note-taking tasks using natural language commands

FAQ from mcp-server-agenda

What are the system requirements?

macOS, Python 3.7+, the Agenda app installed, and the uv Python package installer.

How do I configure Claude Desktop to use this server?

Add the following JSON to $HOME/Library/Application Support/Claude/claude_desktop_config.json: {"mcp-server-agenda": {"command": "uv", "args": ["--directory", "/path/to/your/repo", "run", "mcp-server-agenda"]}}. Replace /path/to/your/repo with your actual home directory path.

What actions does the server support?

It supports create-note, open-note, and create-project via Agenda’s x-callback-url scheme.

How do I install mcp-server-agenda?

Clone the repository, create a pyproject.toml file with required dependencies, then run uv pip install -e . from the project root.

Frequently asked questions

What are the system requirements?

macOS, Python 3.7+, the Agenda app installed, and the `uv` Python package installer.

How do I configure Claude Desktop to use this server?

Add the following JSON to `$HOME/Library/Application Support/Claude/claude_desktop_config.json`: `{"mcp-server-agenda": {"command": "uv", "args": ["--directory", "/path/to/your/repo", "run", "mcp-server-agenda"]}}`. Replace `/path/to/your/repo` with your actual home directory path.

What actions does the server support?

It supports `create-note`, `open-note`, and `create-project` via Agenda’s x-callback-url scheme.

How do I install mcp-server-agenda?

Clone the repository, create a `pyproject.toml` file with required dependencies, then run `uv pip install -e .` from the project root.

Comments

Basic information

More Other MCP servers

ACI: Open-Source Infra to Power Unified MCP Servers

aipotheosis-labs

ACI.dev is the open source tool-calling platform that hooks up 600+ tools into any agentic IDE or custom AI agent through direct function calling or a unified MCP server. The birthplace of VibeOps.

4.8K

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K