Vikunja MCP Server
vikunja-mcp
Удаленный MCP-сервер (Model Context Protocol), который подключает Claude к вашему self-hosted экземпляру Vikunja. Добавьте его как пользовательский коннектор в Claude.ai и управляйте своими задачами в ходе беседы.
Доступные инструменты
Инструмент | Описание |
| Список всех проектов |
| Получить детали проекта |
| Создать новый проект |
| Обновить проект |
| Удалить проект |
| Список/фильтрация/поиск задач во всех проектах |
| Получить детали задачи, включая комментарии |
| Создать задачу в проекте |
| Обновить свойства задачи |
| Удалить задачу |
| Отметить задачу как выполненную |
| Отметить задачу как невыполненную |
| Добавить комментарий к задаче |
| Список всех меток |
| Создать новую метку |
| Прикрепить метку к задаче |
| Удалить метку из задачи |
| Создать сводку еженедельного отчета |
| Просмотр повестки дня с задачами, имеющими сроки (просроченные + предстоящие) |
| Связать две задачи (подзадача, блокировка, предшествование, связь и т.д.) |
| Удалить связь между двумя задачами |
Related MCP server: vikunja-mcp
Быстрый старт
npm install
npm run build
export VIKUNJA_URL=https://your-vikunja-instance.example.com
export VIKUNJA_TOKEN=your-api-token
export MCP_AUTH_TOKEN=$(openssl rand -hex 32)
export PORT=9090
node build/index.jsЗатем добавьте свой сервер как пользовательский коннектор в Claude.ai в разделе Settings > Connectors:
https://your-server.example.com/mcp?token=<MCP_AUTH_TOKEN>См. DEPLOY-UBERSPACE.md для полного руководства по развертыванию на Uberspace.
Конфигурация
Переменная | Обязательно | Описание |
| Да | Базовый URL вашего экземпляра Vikunja (без слеша в конце) |
| Да | API-токен из настроек Vikunja > API Tokens |
| Рекомендуется | Общий секрет для эндпоинта |
| Нет | Порт для прослушивания (по умолчанию: |
Аутентификация
Когда установлен MCP_AUTH_TOKEN, сервер отклоняет любой запрос к /mcp, который
не включает соответствующий параметр запроса ?token=…, возвращая ответ
401 Unauthorized.
Сгенерируйте надежный токен:
openssl rand -hex 32Добавьте его в URL коннектора в Claude.ai:
https://your-server.example.com/mcp?token=<your-token>Если MCP_AUTH_TOKEN не задан, эндпоинт открыт для всех, кто имеет к нему доступ — делайте это только в частной, защищенной брандмауэром сети.
Календарная лента
Сервер предоставляет машиночитаемую ленту iCal, на которую можно подписаться в любом календарном приложении:
webcal://your-server.example.com/calendar.icsОна включает все открытые задачи и задачи, выполненные за последние 30 дней, у которых есть дата начала, срок выполнения или дата окончания. Подпишитесь один раз, и ваше календарное приложение будет опрашивать её автоматически.
Архитектура
Транспорт: Streamable HTTP (без сохранения состояния) — текущий стандарт MCP для удаленных серверов
Аутентификация: Токен в параметре запроса (
MCP_AUTH_TOKEN) для эндпоинта MCP; API-токен Vikunja для исходящих вызовов APIСреда выполнения: Node.js + Express
SDK:
@modelcontextprotocol/sdkv1.x
Требования
Node.js ≥ 18
Self-hosted экземпляр Vikunja с API-токеном
Общедоступный URL, чтобы Claude.ai мог связаться с сервером
This server cannot be deployed
Maintenance
Related MCP Connectors
Persistent context for Claude. Your AI always knows your projects and next actions across sessions.
- platform7nOAuthtech.p7n
Connect Claude to your Platform7n workspaces — chat, links, and tasks. One-click OAuth.
Notes and actions in one app. Let Claude or ChatGPT read and update them.
Personal CRM for Claude. Contacts live as plain-text files in your own Google Drive.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with Vikunja task management instances through natural language. Supports comprehensive project and task operations including CRUD, assignments, labels, comments, relations, and attachments.3344 npm2MIT
- AlicenseCqualityCmaintenanceEnables AI assistants to interact with Vikunja task management via ergonomic and raw REST tools for projects, tasks, labels, and comments.10010 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables to interact with Vikunja task management through its REST API, supporting projects, tasks, comments, labels, assignees, and relations with field preservation.44 npmMIT
- AlicenseCqualityDmaintenanceEnables AI assistants to interact with Vikunja task management instances, providing full task, project, label, and user management capabilities.17141 npmMIT