Yandex Calendar, Mail and Contacts MCP server
yandex-calendar-mcp
An HTTP MCP server for Yandex Calendar over CalDAV, Mail over IMAP and SMTP, and Contacts over CardDAV
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
Why this level
- The server can send mail on the user's behalf and change calendar events and contacts
Install
Manual install
npm install && npm startThe exact environment setup is inferred from the source code; the README does not describe installation.
This is third-party code. Review the repository files before installing.
What it does
The Node.js and Express server exposes MCP over streamable HTTP and bundles three modules on top of Yandex's own protocols: calendar via CalDAV at caldav.yandex.ru, creating iCalendar events and Telemost meeting links; mail via IMAP and SMTP at imap.yandex.ru and smtp.yandex.ru for reading and sending mail; contacts via CardDAV at carddav.yandex.ru. There is no README; the module purposes were confirmed by reading the source code.
Who it is for. For people who want to give an agent access to Yandex calendar, mail and contacts through one server, without ready-made docs.
Good fit when
- You want one server covering Yandex calendar, mail and contacts at once
- You are ready to read the source instead of a README to understand the tools
Not a fit when
- You need documentation with call examples: the repository has no README
- You do not want to hand the server app passwords for three Yandex services at once
Example request
Find today's unread emails and create a calendar event based on one of themLimitations
The repository has no README, only source code. The project is maintained by one author, with no stars. It needs separate app passwords for mail and contacts, an OAuth token for calendar, and an MCP_PATH_SECRET.
How to disable. Stop the node bootstrap.mjs process and remove the server from your MCP client config.
MCP
- Transport
- http
- Authentication
- API key
| Environment variables | |
|---|---|
| YANDEX_EMAIL required | The Yandex mail address the server uses |
| YANDEX_OAUTH_TOKEN required, secret | OAuth token for calendar over CalDAV |
| YANDEX_MAIL_APP_PASSWORD required, secret | App password for IMAP and SMTP mail access |
| YANDEX_CARDDAV_APP_PASSWORD required, secret | App password for CardDAV contacts access |
| MCP_PATH_SECRET required, secret | A secret in the URL path that protects the server's HTTP endpoint |
Security check
- The server can send mail on the user's behalf and change calendar events and contacts
README in short
The repository has no README. The code shows four files: bootstrap.mjs as the entry point, server.mjs with CalDAV calendar and Telemost, mail-patch.mjs with IMAP and SMTP for mail, contacts-patch.mjs with CardDAV for contacts. All modules use Yandex's own protocols with app passwords rather than bypassing any protection.
FAQ
What transport does the server use?
Streamable HTTP via express and StreamableHTTPServerTransport, not stdio.
Related
A self-hosted knowledge base with block-level references and a built-in MCP server for connecting AI agents to your notes
A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more
Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server
A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI