mjucius avatar

Mjucius Cozi Mcp

mjucius/cozi_mcp

Brings your Cozi Family Organizer account into Claude via 12 tools that cover lists, calendar, and family members. You can view and create shopping or todo lists, add and check off items, and manage appointments with attendees. The calendar API is scoped by month, so you pass year and month when fetching or updating events. No OAuth exists for Cozi, so this uses username and password auth stored in your MCP client's keychain or environment. Each user runs their own instance against their own account. The Python v1 was rewritten in TypeScript for v2 with a consolidated tool surface, distributed as MCPB for Claude Desktop, npx for power users, or Smithery for web clients.

GitHub stars
2
tools
15
auth
Secret needed
transport
HTTP
last updated
Sep 13, 2025

Tools

15 tools

Public tool metadata for what this MCP can expose to an agent.

family_membersReturns the family members, call this first to get attendee IDs for appointments.

Returns the family members, call this first to get attendee IDs for appointments.

No parameter schema in public metadata yet.

get_listsReturns the lists, optionally filtered by list type 'shopping' or 'todo'.

Returns the lists, optionally filtered by list type 'shopping' or 'todo'.

No parameter schema in public metadata yet.

get_list_itemsReturns the items of a list, optionally including completed items.

Returns the items of a list, optionally including completed items.

No parameter schema in public metadata yet.

create_listCreates a new list with a name and list type.

Creates a new list with a name and list type.

No parameter schema in public metadata yet.

rename_listRenames a list; its items stay as they are.

Renames a list; its items stay as they are.

No parameter schema in public metadata yet.

delete_listDeletes a list.

Deletes a list.

No parameter schema in public metadata yet.

add_itemAdds an item to a list at a given position.

Adds an item to a list at a given position.

No parameter schema in public metadata yet.

update_itemUpdates the text and/or completed status of a list item.

Updates the text and/or completed status of a list item.

No parameter schema in public metadata yet.

remove_itemsRemoves one or more items from a list.

Removes one or more items from a list.

No parameter schema in public metadata yet.

todayReturns the current local date and time on the machine running the server.

Returns the current local date and time on the machine running the server.

No parameter schema in public metadata yet.

get_calendarReturns the calendar entries for a given year and month.

Returns the calendar entries for a given year and month.

No parameter schema in public metadata yet.

search_calendarSearches calendar appointments across months using Cozi's own search.

Searches calendar appointments across months using Cozi's own search.

No parameter schema in public metadata yet.

create_appointmentCreates a calendar appointment, optionally recurring or all-day, with attendees, reminders and notifications.

Creates a calendar appointment, optionally recurring or all-day, with attendees, reminders and notifications.

No parameter schema in public metadata yet.

update_appointmentPartially updates an existing appointment, with scope options for recurring series.

Partially updates an existing appointment, with scope options for recurring series.

No parameter schema in public metadata yet.

delete_appointmentDeletes an appointment or occurrences of a recurring series.

Deletes an appointment or occurrences of a recurring series.

No parameter schema in public metadata yet.

Sponsors

Readme

Cozi MCP logo

Cozi MCP Server

An unofficial Model Context Protocol server that lets AI assistants like Claude read and update your Cozi Family Organizer lists and calendar.

Each user runs their own instance against their own Cozi account. With the MCPB or npx install, your credentials stay in your MCP client's secure config (Claude Desktop's OS keychain or your local environment) and never leave your machine. With your own server on Cloudflare, they are stored encrypted in your Cloudflare account. Either way, the author of this server has no access to your data.

Install

1. MCPB (recommended for Claude Desktop)

Download the latest .mcpb from the Releases page and double-click to install in Claude Desktop. You'll be prompted for your Cozi username and password. They're stored securely in your OS keychain.

This path requires no Node, npm, or Python install on your machine.

2. npx (any other MCP client)


View the full README on GitHub

Details

Repository
github.com/mjucius/cozi_mcp
Transport
HTTP
Auth
Required
Registry
MCP registry, active