# Настройка MCP CalDAV в Cursor
## Быстрая настройка
1. Откройте Cursor → Settings → Features → MCP Servers → + Add new global MCP server
2. Сначала установите зависимости в проекте:
```bash
cd /Users/admalov/workspace/mcp-servers/caldav
uv sync --dev
```
3. Добавьте конфигурацию:
### Вариант 1: Использование uv run (Рекомендуется для локальной разработки)
Используйте `uv run` с указанием директории проекта:
```json
{
"mcpServers": {
"mcp-caldav": {
"command": "uv",
"args": [
"run",
"--directory",
"/Users/admalov/workspace/mcp-servers/caldav",
"mcp-caldav"
],
"env": {
"CALDAV_URL": "https://caldav.example.com/",
"CALDAV_USERNAME": "your-username",
"CALDAV_PASSWORD": "your-password"
}
}
}
}
```
**Важно:** Замените `/Users/admalov/workspace/mcp-servers/caldav` на абсолютный путь к вашей папке проекта.
### Вариант 2: Прямой путь к исполняемому файлу
Если вы установили пакет через `uv sync`:
```json
{
"mcpServers": {
"mcp-caldav": {
"command": "/Users/admalov/workspace/mcp-servers/caldav/.venv/bin/mcp-caldav",
"env": {
"CALDAV_URL": "https://caldav.example.com/",
"CALDAV_USERNAME": "your-username",
"CALDAV_PASSWORD": "your-password"
}
}
}
}
```
### Вариант 3: Использование pip install
Если вы установили через `pip install -e .`:
```json
{
"mcpServers": {
"mcp-caldav": {
"command": "mcp-caldav",
"env": {
"CALDAV_URL": "https://caldav.example.com/",
"CALDAV_USERNAME": "your-username",
"CALDAV_PASSWORD": "your-password"
}
}
}
}
```
**Примечание:** `uvx` работает только с опубликованными пакетами из PyPI. Для локальной разработки используйте варианты выше.
```json
{
"mcpServers": {
"mcp-caldav": {
"command": "uv",
"args": [
"run",
"--directory",
"/Users/admalov/workspace/mcp-servers/caldav",
"mcp-caldav"
],
"env": {
"CALDAV_URL": "https://caldav.example.com/",
"CALDAV_USERNAME": "your-username",
"CALDAV_PASSWORD": "your-password"
}
}
}
}
```
**Важно:** Замените `/Users/admalov/workspace/mcp-servers/caldav` на путь к вашей папке проекта.
## Примеры для популярных серверов
### Yandex Calendar
```json
{
"mcpServers": {
"mcp-caldav": {
"command": "uv",
"args": [
"run",
"--directory",
"/Users/admalov/workspace/mcp-servers/caldav",
"mcp-caldav"
],
"env": {
"CALDAV_URL": "https://caldav.yandex.ru/",
"CALDAV_USERNAME": "your-username@yandex.ru",
"CALDAV_PASSWORD": "your-app-password"
}
}
}
}
```
**Примечание:** Для Yandex нужен пароль приложения, не основной пароль!
Получить можно здесь: https://id.yandex.ru/security/app-passwords
### Nextcloud
```json
{
"mcpServers": {
"mcp-caldav": {
"command": "uv",
"args": [
"run",
"--directory",
"/Users/admalov/workspace/mcp-servers/caldav",
"mcp-caldav"
],
"env": {
"CALDAV_URL": "https://your-domain.com/remote.php/dav/calendars/username/",
"CALDAV_USERNAME": "your-username",
"CALDAV_PASSWORD": "your-password"
}
}
}
}
```
### ownCloud
```json
{
"mcpServers": {
"mcp-caldav": {
"command": "uv",
"args": [
"run",
"--directory",
"/Users/admalov/workspace/mcp-servers/caldav",
"mcp-caldav"
],
"env": {
"CALDAV_URL": "https://your-domain.com/remote.php/dav/calendars/username/",
"CALDAV_USERNAME": "your-username",
"CALDAV_PASSWORD": "your-password"
}
}
}
}
```
### Apple iCloud
```json
{
"mcpServers": {
"mcp-caldav": {
"command": "uv",
"args": [
"run",
"--directory",
"/Users/admalov/workspace/mcp-servers/caldav",
"mcp-caldav"
],
"env": {
"CALDAV_URL": "https://caldav.icloud.com/",
"CALDAV_USERNAME": "your-apple-id@icloud.com",
"CALDAV_PASSWORD": "your-app-specific-password"
}
}
}
}
```
**Примечание:** Для iCloud нужен app-specific пароль.
Создать можно здесь: https://appleid.apple.com/account/manage → App-Specific Passwords
## Проверка подключения
После добавления конфигурации:
1. Перезапустите Cursor
2. Откройте чат с AI ассистентом
3. Попробуйте использовать инструменты:
- "Покажи мои календари" → должен вызвать `caldav_list_calendars`
- "Какие события у меня сегодня?" → должен вызвать `caldav_get_today_events`
## Отладка
Если сервер не работает:
1. Убедитесь, что зависимости установлены:
```bash
cd /Users/admalov/workspace/mcp-servers/caldav
uv sync --dev
```
2. Проверьте, что `uv` доступен в PATH:
```bash
which uv
```
3. Попробуйте запустить сервер вручную:
```bash
cd /Users/admalov/workspace/mcp-servers/caldav
uv run mcp-caldav --verbose
```
4. Проверьте путь в конфигурации - он должен быть абсолютным
5. Проверьте логи в Cursor (обычно в Developer Tools или MCP Server logs)
6. Убедитесь, что переменные окружения установлены правильно
## Дополнительные опции
Вы можете добавить дополнительные переменные окружения:
```json
{
"mcpServers": {
"mcp-caldav": {
"command": "uv",
"args": [
"run",
"--directory",
"/Users/admalov/workspace/mcp-servers/caldav",
"mcp-caldav"
],
"env": {
"CALDAV_URL": "https://caldav.example.com/",
"CALDAV_USERNAME": "your-username",
"CALDAV_PASSWORD": "your-password",
"MCP_VERBOSE": "true"
}
}
}
}
```
`MCP_VERBOSE=true` включает подробное логирование для отладки.
