Skip to content

feat(calendar): add advanced event search - #218

Open
dtump wants to merge 1 commit into
nextcloud:mainfrom
dtump:feat/advanced-calendar-search
Open

feat(calendar): add advanced event search#218
dtump wants to merge 1 commit into
nextcloud:mainfrom
dtump:feat/advanced-calendar-search

Conversation

@dtump

@dtump dtump commented Jul 30, 2026

Copy link
Copy Markdown

Closes #216.

I built this because I wanted Assistant to answer calendar questions more reliably, for example:

  • What is on my calendar next week?
  • Is there a yearly recurring event for an annual appointment?
  • Do I have anything scheduled around an upcoming holiday?

This adds a separate, read-only Calendar: Advanced Search category. It searches a required, bounded date range across the current user’s event calendars, expands recurring events and exceptions, supports grouped content matching, and reports incomplete or truncated results explicitly.

I kept it separate from calendar.py because the implementation is substantial and it reads full event resources inside Context Agent for recurrence and content matching. The separate category lets admins enable or disable that access independently. Only bounded selected fields are returned to the LLM; descriptions can be matched locally but are not returned. I am happy to adjust the structure if maintainers prefer another approach.

Validated against Context Agent 2.7.0 and current main, with 27 synthetic tests in a separate development harness, the upstream Ruff, Black and isort configuration, and a live Nextcloud test. Because this repository currently has no Python unit-test setup, I did not introduce one solely for this PR. I hope that is okay.

The implementation and test hardening received material AI assistance. I did functional testing myself.

Screenshot because the proof is in the pudding:
Screenshot_20260730_142846

@dtump
dtump force-pushed the feat/advanced-calendar-search branch from eef9769 to 51d53c9 Compare July 30, 2026 12:42
Signed-off-by: Dick Tump <dick@tump.me>
Assisted-by: Codex:gpt-5.6-sol
@dtump
dtump force-pushed the feat/advanced-calendar-search branch from 51d53c9 to e3510a0 Compare July 30, 2026 12:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add MCP tool to list calendar events by date range

1 participant