dav-mcp 3.0.0

package/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [2.7.0] - 2025-10-30
+
+### Added
+- **OAuth2 Authentication Support**: Full OAuth2 support for Google Calendar and other OAuth2-enabled CalDAV servers
+  - New `AUTH_METHOD` environment variable to switch between Basic Auth and OAuth2
+  - Support for Google Calendar via OAuth2 with automatic token refresh
+  - CalDAV discovery via RFC 4791 (no Google Calendar API required)
+  - Tested with Google Calendar (5 calendars discovered and fully functional)
+  - All CRUD operations (Create, Read, Update, Delete) working with OAuth2
+- OAuth2 test suite with 10 comprehensive test cases
+- OAuth2 configuration in `.env.example` with detailed setup instructions
+
+### Changed
+- **Field-agnostic updates**: Integrated tsdav-utils for universal field update support
+  - `update_event` now supports all RFC 5545 iCalendar properties (SUMMARY, DESCRIPTION, LOCATION, DTSTART, DTEND, STATUS, etc.)
+  - `update_todo` now supports all RFC 5545 VTODO properties (SUMMARY, DESCRIPTION, STATUS, PRIORITY, DUE, PERCENT-COMPLETE, etc.)
+  - `update_contact` now supports all RFC 6350 vCard properties (FN, N, EMAIL, TEL, ORG, TITLE, NOTE, URL, ADR, BDAY, etc.)
+  - All update tools now accept custom X-* properties for extensions (e.g., X-ZOOM-LINK, X-MEETING-ROOM)
+- Replaced manual iCal/vCard string manipulation with structured field updates via tsdav-utils
+- Simplified update tool implementations (reduced code by 40-45% per tool)
+- Updated input schemas to accept any RFC property name (field-agnostic validation)
+- Enhanced `tsdav-client.js` to support both Basic Auth and OAuth2 authentication methods
+- Updated `index.js` initialization logic to auto-detect authentication method
+
+### Dependencies
+- Added: tsdav-utils (v0.1.0) - Field-agnostic utility layer for RFC-compliant updates
+
+### Compatibility
+- Fully backward compatible with existing Basic Auth setup
+- No breaking changes - existing configurations continue to work
+- Google Calendar tested and verified with OAuth2
+
+## [2.6.0] - Previous Release
+
+Initial release with 26 MCP tools for CalDAV, CardDAV, and VTODO operations.
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 tsdav-mcp-server contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,260 @@
+# dav-mcp
+
+**Give your AI agents the power of organization** — Transform them into orchestrating assistants managing calendars, contacts, and tasks.
+
+Built on 26 production-ready tools spanning CalDAV, CardDAV, and VTODO protocols.
+
+Built for n8n, Claude Desktop, and any MCP client.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![npm version](https://badge.fury.io/js/dav-mcp.svg)](https://www.npmjs.com/package/dav-mcp)
+
+---
+
+### The Orchestration 
+
+When partial tools force your AI to improvise, complete tools let it **execute precise operations across all components**.
+
+| Capability | dav-mcp | Most MCPs |
+|------------|---------|-------------------|
+| **Calendar Management** | ✅ Full CRUD (11 tools) | ⚠️ Create + list only (2-3 tools) |
+| **Contact Management** | ✅ Complete CardDAV (8 tools) | ❌ Often missing entirely |
+| **Task Management** | ✅ Full VTODO support (7 tools) | ❌ Rarely included |
+| **Field-Based Updates** | ✅ All RFC properties + custom fields | ❌ Rarely available |
+| **Server-Side Filtering** | ✅ Efficient queries | ❌ Dumps all data |
+| **Multi-Provider** | ✅ Any CalDAV/CardDAV server | ⚠️ Limited provider support |
+| **Total Tools** | **26 tools** | **2-6 tools** |
+
+
+---
+
+## 🚀 Full Feature Set
+
+### Protocol Support
+- **26 MCP Tools**: Full CRUD operations for calendars, contacts, and tasks
+- **CalDAV Integration**: ~88% tsdav coverage (11 tools)
+- **CardDAV Integration**: 100% tsdav coverage (8 tools)
+- **VTODO Support**: Full task management with status, priorities, due dates (7 tools)
+- **Field-Based Updates**: Field-agnostic updates via tsdav-utils - supports all RFC 5545/6350 properties + custom X-* fields
+- **RFC-Compliant**: ical.js for RFC 5545 (iCalendar) and RFC 6350 (vCard) support
+
+### Production-Ready Infrastructure
+- **MCP Protocol**: STDIO transport for local clients, Stateless HTTP for remote
+- **Multi-Server Tested**: Works with Radicale, Baikal, Nextcloud, iCloud
+- **Bearer Auth**: Token authentication for HTTP transport
+- **Structured Logging**: Custom JSON logger with millisecond precision
+
+### Efficiency Features
+- **Server-Side Filtering**: calendar_query, addressbook_query, todo_query with smart filters reduce data transfer
+- **LLM-Optimized Tool Design**: PREFERRED/WARNING labels guide AI to efficient choices
+- **Batch Operations**: multi_get tools fetch multiple specific items without loading entire collections
+
+---
+
+## 📋 Available Tools (26 Total)
+
+
+### CalDAV Tools (11 tools)
+
+1. **list_calendars** - List all available calendars
+2. **list_events** - List ALL events (⚠️ WARNING: use calendar_query for filtered searches)
+3. **create_event** - Create a new calendar event
+4. **update_event** - ⭐ PREFERRED: Update any event field (SUMMARY, LOCATION, DTSTART, STATUS, custom X-* properties)
+5. **update_event_raw** - Update event with raw iCal data (advanced)
+6. **delete_event** - Delete an event permanently
+7. **calendar_query** - ⭐ PREFERRED: Search and filter events efficiently by text, date range, or location
+8. **make_calendar** - Create a new calendar collection
+9. **update_calendar** - Update calendar properties (display name, description, color, timezone)
+10. **delete_calendar** - Permanently delete a calendar and all its events
+11. **calendar_multi_get** - Batch fetch multiple specific events by URLs
+
+### CardDAV Tools (8 tools)
+
+12. **list_addressbooks** - List all available address books
+13. **list_contacts** - List ALL contacts (⚠️ WARNING: use addressbook_query for filtered searches)
+14. **create_contact** - Create a new contact (vCard)
+15. **update_contact** - ⭐ PREFERRED: Update any contact field (FN, EMAIL, TEL, ORG, ADR, custom X-* properties)
+16. **update_contact_raw** - Update contact with raw vCard data (advanced)
+17. **delete_contact** - Delete a contact permanently
+18. **addressbook_query** - ⭐ PREFERRED: Search and filter contacts efficiently by name, email, or organization
+19. **addressbook_multi_get** - Batch fetch multiple specific contacts by URLs
+
+### VTODO Tools (7 tools)
+
+20. **list_todos** - List ALL todos/tasks (⚠️ WARNING: use todo_query for filtered searches)
+21. **create_todo** - Create a new todo/task with optional due date, priority, status
+22. **update_todo** - ⭐ PREFERRED: Update any todo field (SUMMARY, STATUS, PRIORITY, DUE, PERCENT-COMPLETE, custom X-* properties)
+23. **update_todo_raw** - Update todo with raw VTODO iCal data (advanced)
+24. **delete_todo** - Delete a todo/task permanently
+25. **todo_query** - ⭐ PREFERRED: Search and filter todos efficiently by status/due date
+26. **todo_multi_get** - Batch fetch multiple specific todos by URLs
+
+---
+
+## 💡 Real-World Applications
+
+See how complete tool coverage transforms basic operations into powerful workflows.
+
+### n8n Automation Workflows
+- **Meeting Management**: "Show me all Friday meetings" → calendar_query with date filter returns only relevant events
+- **Contact Search**: "Find everyone at Google" → addressbook_query with org filter finds matches efficiently
+- **Task Reporting**: "Show overdue high-priority tasks" → todo_query with filters returns specific results
+- **Scheduled Cleanup**: Daily cron job deletes completed tasks using targeted queries
+
+### Claude Desktop Integration
+- **Quick Event Creation**: "Create team meeting tomorrow 2 PM" → create_event executes immediately
+- **Contact Lookup**: "What's Sarah's email?" → addressbook_query with name filter finds contact
+- **Calendar Overview**: "What's on my calendar next week?" → calendar_query with date range shows events
+- **Calendar Management**: "Create a new calendar called Project Luna" → make_calendar creates collection
+
+---
+
+## 🛠️ Start Orchestrating in 5 Minutes
+
+### Installation
+
+```bash
+git clone https://github.com/PhilflowIO/dav-mcp.git
+cd dav-mcp
+npm install
+cp .env.example .env
+```
+
+### Configuration
+
+Edit `.env`:
+
+```env
+# CalDAV/CardDAV Server
+CALDAV_SERVER_URL=https://dav.example.com
+CALDAV_USERNAME=your_username
+CALDAV_PASSWORD=your_password
+
+# MCP Server
+PORT=3000
+MCP_SERVER_NAME=dav-mcp
+MCP_SERVER_VERSION=2.6.0
+
+# Authentication (optional)
+BEARER_TOKEN=your-secure-token-here
+```
+
+### Start Server
+
+```bash
+npm start
+# Server runs on: http://localhost:3000
+```
+
+---
+
+## 🔗 Integration
+
+### n8n Workflow
+
+1. **Start HTTP server**: `BEARER_TOKEN=your-token npm run start:http`
+2. **Add "AI Agent" node**
+3. **Add "MCP Client Tool" node** and connect to AI Agent
+4. **Configure the connection:**
+   - **MCP Endpoint**: `http://localhost:3000/mcp`
+   - **Authentication Method**: `Bearer`
+   - **Bearer Token**: Your token
+
+5. **Example prompts:**
+
+```
+"List all my calendars"
+"Create a meeting tomorrow at 2 PM"
+"Show me all events in October"
+"Find all contacts at Google"
+"Create a new contact for Jane Smith"
+"Show overdue tasks with high priority"
+```
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "dav-mcp": {
+      "command": "node",
+      "args": ["/absolute/path/to/dav-mcp/src/server-stdio.js"],
+      "env": {
+        "CALDAV_SERVER_URL": "https://dav.example.com",
+        "CALDAV_USERNAME": "your_username",
+        "CALDAV_PASSWORD": "your_password"
+      }
+    }
+  }
+}
+```
+
+**Config file locations:**
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+- **Linux**: `~/.config/Claude/claude_desktop_config.json`
+
+**Restart Claude Desktop** after adding the configuration.
+
+---
+
+## 🌐 Works Across All Major Providers
+
+Works with any CalDAV/CardDAV server that follows RFC 4791 and RFC 6352:
+
+- ✅ **Nextcloud** - Full support
+- ✅ **Baikal** - Full support
+- ✅ **Radicale** - Full support
+- ✅ **iCloud** - Works with app-specific password
+- ✅ **Any RFC-compliant server** - Standard protocol support
+
+
+## 🔒 Security
+
+- **Input Validation**: All inputs validated with Zod schemas before execution
+- **Rate Limiting**: 100 requests/minute per session
+- **Bearer Auth**: Optional token authentication
+- **No Credential Storage**: Pass-through only, never logged or cached
+- **Structured Logging**: Audit trail with request IDs, no PII exposure
+- **CORS Protection**: Whitelist origins, block cross-site attacks
+
+
+
+## 📚 Documentation
+
+- **[MCP Specification](https://modelcontextprotocol.io/specification/2025-03-26)** - Model Context Protocol docs
+- **[tsdav Docs](https://tsdav.vercel.app/docs/intro)** - CalDAV/CardDAV library reference
+- **[CalDAV RFC 4791](https://datatracker.ietf.org/doc/html/rfc4791)** - CalDAV protocol specification
+- **[CardDAV RFC 6352](https://datatracker.ietf.org/doc/html/rfc6352)** - CardDAV protocol specification
+
+---
+
+## 🤝 Contributing
+
+Pull requests are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+---
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details
+
+---
+
+## 🙏 Acknowledgments
+
+Built with:
+- **[tsdav](https://github.com/natelindev/tsdav)** - Excellent TypeScript CalDAV/CardDAV library
+- **[tsdav-utils](https://github.com/PhilflowIO/tsdav-utils)** - Field-agnostic utility layer for RFC-compliant field updates
+- **[MCP SDK](https://modelcontextprotocol.io)** - Model Context Protocol by Anthropic
+- **[ical.js](https://github.com/kewisch/ical.js)** - RFC-compliant iCalendar parser
+
+---
+
+**Questions? Issues?** Create a [GitHub issue](https://github.com/PhilflowIO/dav-mcp/issues)
+
+---
+
+*Built for AI agents managing calendars, contacts, and tasks*

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "dav-mcp",
+  "version": "3.0.0",
+  "description": "Complete DAV integration for AI - Calendar (CalDAV), Contacts (CardDAV), and Tasks (VTODO) management via MCP protocol",
+  "type": "module",
+  "main": "src/server-stdio.js",
+  "bin": {
+    "dav-mcp": "src/server-stdio.js"
+  },
+  "scripts": {
+    "start": "MCP_TRANSPORT=stdio node src/server-stdio.js",
+    "start:stdio": "MCP_TRANSPORT=stdio node src/server-stdio.js",
+    "start:http": "node src/server-http.js",
+    "dev": "MCP_TRANSPORT=stdio node --watch src/server-stdio.js",
+    "dev:http": "node --watch src/server-http.js",
+    "install:fresh": "rm -rf node_modules package-lock.json && npm cache clean --force && npm install",
+    "update:tsdav": "npm cache clean --force && npm install tsdav@github:PhilflowIO/tsdav#master",
+    "test": "NODE_ENV=test NODE_OPTIONS='--experimental-vm-modules' jest",
+    "test:watch": "NODE_ENV=test NODE_OPTIONS='--experimental-vm-modules' jest --watch",
+    "test:coverage": "NODE_ENV=test NODE_OPTIONS='--experimental-vm-modules' jest --coverage",
+    "test:integration": "node tests/integration/mcp-test-runner.js",
+    "test:setup-data": "node tests/integration/setup-test-data.js"
+  },
+  "author": "dav-mcp contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PhilflowIO/dav-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/PhilflowIO/dav-mcp/issues"
+  },
+  "homepage": "https://github.com/PhilflowIO/dav-mcp#readme",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "caldav",
+    "carddav",
+    "vtodo",
+    "dav",
+    "calendar",
+    "contacts",
+    "tasks",
+    "todos",
+    "n8n",
+    "ai",
+    "llm",
+    "automation",
+    "nextcloud",
+    "baikal",
+    "radicale"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "src/**/*",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.18.2",
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.7",
+    "express": "^4.21.2",
+    "express-rate-limit": "^8.1.0",
+    "ical.js": "^2.2.1",
+    "tsdav": "github:PhilflowIO/tsdav#master",
+    "tsdav-utils": "github:PhilflowIO/tsdav-utils#main",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.0",
+    "@types/jest": "^30.0.0",
+    "jest": "^30.2.0",
+    "pnpm": "^10.19.0"
+  }
+}

package/src/error-handler.js

@@ -0,0 +1,215 @@
+/**
+ * MCP Standard Error Codes
+ * Following JSON-RPC 2.0 error code specification
+ */
+export const MCP_ERROR_CODES = {
+  // JSON-RPC standard errors
+  PARSE_ERROR: -32700,
+  INVALID_REQUEST: -32600,
+  METHOD_NOT_FOUND: -32601,
+  INVALID_PARAMS: -32602,
+  INTERNAL_ERROR: -32603,
+
+  // Custom application errors (range -32000 to -32099)
+  CALDAV_ERROR: -32000,
+  CARDDAV_ERROR: -32001,
+  VALIDATION_ERROR: -32002,
+  AUTH_ERROR: -32003,
+  NETWORK_ERROR: -32004,
+  TIMEOUT_ERROR: -32005,
+  NOT_FOUND_ERROR: -32006,
+  CONFLICT_ERROR: -32007,
+};
+
+/**
+ * Error type to code mapping
+ */
+const ERROR_TYPE_MAP = {
+  'TypeError': MCP_ERROR_CODES.INVALID_PARAMS,
+  'ValidationError': MCP_ERROR_CODES.VALIDATION_ERROR,
+  'AuthenticationError': MCP_ERROR_CODES.AUTH_ERROR,
+  'NetworkError': MCP_ERROR_CODES.NETWORK_ERROR,
+  'TimeoutError': MCP_ERROR_CODES.TIMEOUT_ERROR,
+  'NotFoundError': MCP_ERROR_CODES.NOT_FOUND_ERROR,
+  'ConflictError': MCP_ERROR_CODES.CONFLICT_ERROR,
+};
+
+/**
+ * Get error code based on error type or message
+ */
+function getErrorCode(error) {
+  // Check if error has explicit code
+  if (error.code && typeof error.code === 'number') {
+    return error.code;
+  }
+
+  // Map by error type
+  if (error.name && ERROR_TYPE_MAP[error.name]) {
+    return ERROR_TYPE_MAP[error.name];
+  }
+
+  // Check error message for CalDAV/CardDAV specific errors
+  const message = error.message?.toLowerCase() || '';
+  if (message.includes('caldav')) {
+    return MCP_ERROR_CODES.CALDAV_ERROR;
+  }
+  if (message.includes('carddav')) {
+    return MCP_ERROR_CODES.CARDDAV_ERROR;
+  }
+  if (message.includes('auth') || message.includes('unauthorized') || message.includes('forbidden')) {
+    return MCP_ERROR_CODES.AUTH_ERROR;
+  }
+  if (message.includes('not found') || message.includes('404')) {
+    return MCP_ERROR_CODES.NOT_FOUND_ERROR;
+  }
+  if (message.includes('timeout')) {
+    return MCP_ERROR_CODES.TIMEOUT_ERROR;
+  }
+  if (message.includes('network') || message.includes('connection')) {
+    return MCP_ERROR_CODES.NETWORK_ERROR;
+  }
+  if (message.includes('validation') || message.includes('invalid')) {
+    return MCP_ERROR_CODES.VALIDATION_ERROR;
+  }
+
+  // Default to internal error
+  return MCP_ERROR_CODES.INTERNAL_ERROR;
+}
+
+/**
+ * Format error into MCP-compliant structure
+ */
+export function formatMCPError(error, includeStack = false) {
+  const code = getErrorCode(error);
+
+  const errorResponse = {
+    code,
+    message: error.message || 'An error occurred',
+    data: {
+      type: error.name || 'Error',
+      ...(error.details && { details: error.details }),
+      ...(includeStack && error.stack && { stack: error.stack }),
+    },
+  };
+
+  return errorResponse;
+}
+
+/**
+ * Create MCP tool error response
+ */
+export function createToolErrorResponse(error, includeStack = false) {
+  const mcpError = formatMCPError(error, includeStack);
+
+  return {
+    content: [
+      {
+        type: 'text',
+        text: JSON.stringify(mcpError, null, 2),
+      },
+    ],
+    isError: true,
+  };
+}
+
+/**
+ * Create HTTP error response
+ */
+export function createHTTPErrorResponse(error, statusCode = null) {
+  const mcpError = formatMCPError(error, process.env.NODE_ENV === 'development');
+
+  // Map MCP error codes to HTTP status codes
+  const defaultStatusCode = statusCode || mapMCPCodeToHTTPStatus(mcpError.code);
+
+  return {
+    statusCode: defaultStatusCode,
+    body: {
+      error: mcpError.message,
+      code: mcpError.code,
+      ...mcpError.data,
+    },
+  };
+}
+
+/**
+ * Map MCP error codes to HTTP status codes
+ */
+function mapMCPCodeToHTTPStatus(code) {
+  switch (code) {
+    case MCP_ERROR_CODES.PARSE_ERROR:
+    case MCP_ERROR_CODES.INVALID_REQUEST:
+    case MCP_ERROR_CODES.INVALID_PARAMS:
+    case MCP_ERROR_CODES.VALIDATION_ERROR:
+      return 400; // Bad Request
+
+    case MCP_ERROR_CODES.METHOD_NOT_FOUND:
+    case MCP_ERROR_CODES.NOT_FOUND_ERROR:
+      return 404; // Not Found
+
+    case MCP_ERROR_CODES.AUTH_ERROR:
+      return 401; // Unauthorized
+
+    case MCP_ERROR_CODES.CONFLICT_ERROR:
+      return 409; // Conflict
+
+    case MCP_ERROR_CODES.TIMEOUT_ERROR:
+      return 408; // Request Timeout
+
+    case MCP_ERROR_CODES.NETWORK_ERROR:
+      return 502; // Bad Gateway
+
+    case MCP_ERROR_CODES.CALDAV_ERROR:
+    case MCP_ERROR_CODES.CARDDAV_ERROR:
+    case MCP_ERROR_CODES.INTERNAL_ERROR:
+    default:
+      return 500; // Internal Server Error
+  }
+}
+
+/**
+ * Custom error classes
+ */
+export class ValidationError extends Error {
+  constructor(message, details = null) {
+    super(message);
+    this.name = 'ValidationError';
+    this.code = MCP_ERROR_CODES.VALIDATION_ERROR;
+    this.details = details;
+  }
+}
+
+export class AuthenticationError extends Error {
+  constructor(message, details = null) {
+    super(message);
+    this.name = 'AuthenticationError';
+    this.code = MCP_ERROR_CODES.AUTH_ERROR;
+    this.details = details;
+  }
+}
+
+export class NotFoundError extends Error {
+  constructor(message, details = null) {
+    super(message);
+    this.name = 'NotFoundError';
+    this.code = MCP_ERROR_CODES.NOT_FOUND_ERROR;
+    this.details = details;
+  }
+}
+
+export class CalDAVError extends Error {
+  constructor(message, details = null) {
+    super(message);
+    this.name = 'CalDAVError';
+    this.code = MCP_ERROR_CODES.CALDAV_ERROR;
+    this.details = details;
+  }
+}
+
+export class CardDAVError extends Error {
+  constructor(message, details = null) {
+    super(message);
+    this.name = 'CardDAVError';
+    this.code = MCP_ERROR_CODES.CARDDAV_ERROR;
+    this.details = details;
+  }
+}