How do I use desktop-calendar-tauri?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@desktop-calendar-tauri what's my schedule for next Monday?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

desktop-calendar-tauri

by tianjiashu

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

DayPilot

DayPilot is a local-first desktop calendar for both humans and AI agents. Humans manage schedules through a lightweight desktop UI, while agents use the built-in local MCP server to read and write the same SQLite calendar database.

Languages: English | 中文

English

Highlights

Floating desktop widget that starts near the bottom-right area and shows today's date and events.
Expandable 7-day week view with time grid, event cards, editing, deletion, and drag updates.
Local SQLite storage shared by the GUI and MCP tools.
Built-in Streamable HTTP MCP server at http://127.0.0.1:18765/mcp.
MCP Apps Widgets for interactive event lists, event details, and free-slot results.
Real-time sync between GUI writes and MCP writes.
Single-instance desktop startup: opening the executable again focuses the existing app.
System tray menu for show, hide, and quit.
System theme aware dark mode.

Architecture

Human user
  -> Tauri desktop window
  -> React UI
  -> Zustand store
  -> Tauri IPC
  -> SQLite

AI agent
  -> MCP client
  -> Local MCP HTTP server
  -> MCP tools
  -> SQLite
  -> db:events_changed
  -> React UI refresh

Tech Stack

Layer	Technology
Desktop shell	Tauri 2
Frontend	React 18, TypeScript, Vite 6
UI	Phosphor Icons, Geist Sans/Mono, CSS variables
State	Zustand
Database	SQLite, rusqlite
Agent protocol	rmcp Streamable HTTP Server, MCP Apps Widgets
Tests	Vitest, Cargo test

MCP Tools

Tool	Description
`list_events`	List events in a fixed time range and optionally return an events-list widget.
`get_event`	Fetch a single event and optionally return an event-detail widget.
`create_event`	Create an event with validation and UI sync.
`update_event`	Update an event. Supports `clear_fields` for nullable fields.
`delete_event`	Soft-delete an event.
`get_free_slots`	Query free slots for a `YYYY-MM-DD` date and optionally return a widget.

MCP time inputs use fixed string formats:

Date time: YYYY-MM-DD HH:mm
Date: YYYY-MM-DD
Time zone: interpreted as Asia/Shanghai
Internal storage: Unix milliseconds

MCP Client Configuration

Start the desktop app first. The MCP server starts with the app.

{
  "mcpServers": {
    "desktop-calendar": {
      "type": "http",
      "url": "http://127.0.0.1:18765/mcp"
    }
  }
}

Health check:

http://127.0.0.1:18765/health

Quick Start

Prerequisites:

Node.js
Rust toolchain
Tauri system dependencies for your platform

Install dependencies:

npm install

Run the frontend dev server:

npm run dev

Run the Tauri desktop app:

npm run tauri dev

Build the frontend:

npm run build

Run tests:

npm test

cd src-tauri
cargo test

Project Structure

desktop-calendar-tauri/
├─ src/
│  ├─ components/
│  │  ├─ Calendar/          # Event cards, dialog, tooltip
│  │  ├─ Common/            # Error boundary, toast, diagnostics, status bar
│  │  ├─ WeekView/          # Week grid, header, time line, day columns
│  │  └─ Widget/            # Floating desktop widget
│  ├─ hooks/                # Stateful frontend workflows
│  ├─ services/             # Tauri IPC boundary
│  ├─ stores/               # Zustand global state
│  ├─ utils/                # Pure utilities
│  ├─ constants/            # Shared constants
│  └─ types/                # TypeScript types
├─ src-tauri/
│  ├─ src/
│  │  ├─ commands/          # Tauri IPC commands
│  │  ├─ db/                # SQLite schema, migrations, repositories
│  │  ├─ mcp/               # MCP server, tools, resources, widgets
│  │  └─ models/            # Rust data models
│  └─ tests/                # Rust integration tests
├─ docs/
│  └─ DEVELOPMENT-GUIDELINES.md
└─ README.md

Platform Status

Platform	Status	Notes
Windows	Verified	Tray, transparent window, bottom-right positioning, single instance, and MCP server are tested.
macOS	Expected, not fully verified	Core stack is cross-platform, but menu bar tray icon, Dock behavior, transparent always-on-top windows, signing, and notarization still need validation.
Linux	Not verified	Core stack is cross-platform, but tray and transparent-window behavior depend on the desktop environment.

Development Guidelines

Project-specific rules live in docs/DEVELOPMENT-GUIDELINES.md.

Key boundaries:

App.tsx is composition only.
UI components should not call Tauri IPC directly.
Stores call src/services/tauriCommands.ts, not raw invokeSafe or invokeOrThrow.
Feature CSS belongs next to the feature, not in App.css.
Temporary logs, generated outputs, coverage files, and local scripts should not be committed.

License

MIT

Related MCP server: Temporal Cortex MCP

中文

DayPilot 是一个面向人类用户和 AI Agent 的本地优先桌面日历。人类通过轻量桌面界面管理日程，Agent 通过内置本地 MCP Server 读写同一份 SQLite 日历数据库。

项目亮点

默认停靠在右下区域的悬浮桌面 Widget，展示日期和今日日程概览。
可展开的 7 日周视图，支持时间网格、事件卡片、编辑、删除和拖拽更新时间。
GUI 和 MCP 工具共享同一份本地 SQLite 数据。
内置 Streamable HTTP MCP Server，默认地址为 http://127.0.0.1:18765/mcp。
支持 MCP Apps Widget，可在 Agent 对话中展示事件列表、事件详情和空闲时间。
GUI 写入和 MCP 写入会实时同步。
单实例启动，重复打开 exe 会唤起已有窗口。
系统托盘菜单支持显示、隐藏和退出。
暗色模式跟随系统主题。

架构概览

人类用户
  -> Tauri 桌面窗口
  -> React UI
  -> Zustand store
  -> Tauri IPC
  -> SQLite

AI Agent
  -> MCP client
  -> 本地 MCP HTTP server
  -> MCP tools
  -> SQLite
  -> db:events_changed
  -> React UI 刷新

技术栈

层级	技术
桌面壳	Tauri 2
前端	React 18, TypeScript, Vite 6
UI	Phosphor Icons, Geist Sans/Mono, CSS variables
状态管理	Zustand
数据库	SQLite, rusqlite
Agent 协议	rmcp Streamable HTTP Server, MCP Apps Widgets
测试	Vitest, Cargo test

MCP 工具

工具	说明
`list_events`	按固定时间范围查询事件，可返回事件列表 Widget。
`get_event`	查询单个事件详情，可返回事件详情 Widget。
`create_event`	创建事件，并进行参数校验和界面同步。
`update_event`	更新事件，支持用 `clear_fields` 清空可空字段。
`delete_event`	软删除事件。
`get_free_slots`	按 `YYYY-MM-DD` 查询空闲时间段，可返回空闲时间 Widget。

MCP 时间入参使用固定字符串格式：

日期时间：YYYY-MM-DD HH:mm
日期：YYYY-MM-DD
时区：按 Asia/Shanghai 解读
内部存储：Unix milliseconds

MCP 客户端配置

先启动桌面应用，MCP Server 会随应用自动启动。

{
  "mcpServers": {
    "desktop-calendar": {
      "type": "http",
      "url": "http://127.0.0.1:18765/mcp"
    }
  }
}

健康检查：

http://127.0.0.1:18765/health

快速开始

前置要求：

Node.js
Rust toolchain
当前平台所需的 Tauri 系统依赖

安装依赖：

npm install

启动前端开发服务：

npm run dev

启动 Tauri 桌面应用：

npm run tauri dev

构建前端：

npm run build

运行测试：

npm test

cd src-tauri
cargo test

项目结构

desktop-calendar-tauri/
├─ src/
│  ├─ components/
│  │  ├─ Calendar/          # 事件卡片、弹窗、Tooltip
│  │  ├─ Common/            # 错误边界、Toast、诊断面板、状态栏
│  │  ├─ WeekView/          # 周视图网格、头部、时间线、日列
│  │  └─ Widget/            # 悬浮桌面 Widget
│  ├─ hooks/                # 前端状态流程
│  ├─ services/             # Tauri IPC 边界
│  ├─ stores/               # Zustand 全局状态
│  ├─ utils/                # 纯工具函数
│  ├─ constants/            # 共享常量
│  └─ types/                # TypeScript 类型
├─ src-tauri/
│  ├─ src/
│  │  ├─ commands/          # Tauri IPC 命令
│  │  ├─ db/                # SQLite schema、迁移、仓库层
│  │  ├─ mcp/               # MCP server、tools、resources、widgets
│  │  └─ models/            # Rust 数据模型
│  └─ tests/                # Rust 集成测试
├─ docs/
│  └─ DEVELOPMENT-GUIDELINES.md
└─ README.md

平台兼容性

平台	状态	说明
Windows	已验证	托盘、透明窗口、右下角定位、单实例和 MCP Server 均已测试。
macOS	理论兼容，尚未完整验证	核心技术栈跨平台，但菜单栏图标、Dock 行为、透明置顶窗口、签名和 notarization 仍需验证。
Linux	未验证	核心技术栈跨平台，但托盘和透明窗口行为依赖桌面环境。

开发规范

项目专用开发规范见 docs/DEVELOPMENT-GUIDELINES.md。

关键边界：

App.tsx 只做组合，不承载业务细节。
UI 组件不直接调用 Tauri IPC。
Store 统一调用 src/services/tauriCommands.ts，不直接调用 invokeSafe 或 invokeOrThrow。
功能样式放在对应功能目录，不再塞回 App.css。
临时日志、生成产物、覆盖率文件和本地实验脚本不提交。

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

CalendarMCP
ai.calendarmcp
Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.
Calendar Management Workplace & Productivity
2
outlook-calendarOAuth
com.mintmcp
A MCP server that works with Outlook Calendar to manage event listing, reading, and updates.
Calendar Management Communication App Automation
38
gcal AOAuth
com.mintmcp
A MCP server that works with Google Calendar to manage event listing, reading, and updates.
Calendar Management App Automation
72
AstrocalOAuth
dev.astrocal
AI-native scheduling: check availability, book meetings, cancel and reschedule via MCP
Calendar Management Workplace & Productivity
21

Related MCP Servers

mcp-labrat
Calendar Management App Automation
hussainkazemian
F
license
Not graded
quality
D
maintenance
An MCP server that enables interaction with CalDAV calendars to manage events and check availability through natural language or voice commands. It provides specific tools for listing, searching, and creating calendar entries using an OpenAI-compatible interface.
Updated 7 months ago (2026-02-09 15:36 UTC)
-
Temporal Cortex MCP
Autonomous Agents Calendar Management Developer Tools
temporal-cortex
A
license
A
quality
C
maintenance
Calendar MCP server with atomic booking, conflict prevention, deterministic RRULE expansion, and TOON token compression for AI agents.
Updated 17 days ago (2026-08-31 21:06 UTC)
18
12
MIT
@calmesh/mcp-server
Calendar Management Workplace & Productivity
davidklemme
A
license
A
quality
D
maintenance
MCP server that connects AI agents to calendars, bookings, and scheduling polls via the Model Context Protocol.
Updated 3 months ago (2026-06-09 17:26 UTC)
22
7 npm
MIT
calendar-mcp
Calendar Management Workplace & Productivity
apex-500
A
license
Not graded
quality
Not graded
maintenance
MCP server that lets AI agents manage Google Calendar -- create events, check availability, and manage schedules.
Updated 6 months ago (2026-03-13 05:27 UTC)
MIT

DayPilot

English

Highlights

Architecture

Tech Stack

MCP Tools

MCP Client Configuration

Quick Start

Project Structure

Platform Status

Development Guidelines

License

中文

项目亮点

架构概览

技术栈

MCP 工具

MCP 客户端配置

快速开始

项目结构

平台兼容性

开发规范

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

mcp-labrat

Temporal Cortex MCP

@calmesh/mcp-server

calendar-mcp