MinerU
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
Read your mail and manage your calendar on your own IMAP and CalDAV servers.
Texto original del autor
Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
A privacy-first app that strips AI watermarks from content you own.
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 4/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 16/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala pim-mcp. Sigue https://mcp.popnx.com/i/robinvdvleuten-pim-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de pim-mcp (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server pim-mcp para Claude en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "pim": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "PIM_MCP_PASSWORD", "ghcr.io/robinvdvleuten/pim-mcp:v0.1.0" ], "env": { "PIM_MCP_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En PIM_MCP_PASSWORD deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de pim-mcp aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
SettingsDeveloperEdit Config
{
"mcpServers": {
"pim": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PIM_MCP_PASSWORD",
"ghcr.io/robinvdvleuten/pim-mcp:v0.1.0"
],
"env": {
"PIM_MCP_PASSWORD": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa pim-mcp y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando pim-mcp o muestra una herramienta de pim-mcp en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
PIM_MCP_READ_ONLY Establezca en 1 para eliminar todas las herramientas que puedan modificar algo. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar pim-mcp
pim-mcp se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar pim-mcp
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de pim-mcp (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server pim-mcp para Claude Code en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user pim --env PIM_MCP_PASSWORD=your-value -- docker run -i --rm -e PIM_MCP_PASSWORD ghcr.io/robinvdvleuten/pim-mcp:v0.1.0 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En PIM_MCP_PASSWORD deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de pim-mcp aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user pim --env PIM_MCP_PASSWORD=your-value -- docker run -i --rm -e PIM_MCP_PASSWORD ghcr.io/robinvdvleuten/pim-mcp:v0.1.0Cambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver pim-mcp en la lista como conectado
Usa pim-mcp y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando pim-mcp o muestra una herramienta de pim-mcp en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
PIM_MCP_READ_ONLY Establezca en 1 para eliminar todas las herramientas que puedan modificar algo. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de pim-mcp (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server pim-mcp para Cursor en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "pim": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "PIM_MCP_PASSWORD", "ghcr.io/robinvdvleuten/pim-mcp:v0.1.0" ], "env": { "PIM_MCP_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En PIM_MCP_PASSWORD deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de pim-mcp aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
En la configuración de pim-mcp, PIM_MCP_PASSWORD está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa pim-mcp y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando pim-mcp o muestra una herramienta de pim-mcp en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
PIM_MCP_READ_ONLY Establezca en 1 para eliminar todas las herramientas que puedan modificar algo. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de pim-mcp (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server pim-mcp para VS Code en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "pim": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "-e", "PIM_MCP_PASSWORD", "ghcr.io/robinvdvleuten/pim-mcp:v0.1.0" ], "env": { "PIM_MCP_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En PIM_MCP_PASSWORD deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de pim-mcp aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
En la configuración de pim-mcp, PIM_MCP_PASSWORD está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa pim-mcp y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando pim-mcp o muestra una herramienta de pim-mcp en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
PIM_MCP_READ_ONLY Establezca en 1 para eliminar todas las herramientas que puedan modificar algo. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user pim --env PIM_MCP_PASSWORD=your-value -- docker run -i --rm -e PIM_MCP_PASSWORD ghcr.io/robinvdvleuten/pim-mcp:v0.1.0Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"pim": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PIM_MCP_PASSWORD",
"ghcr.io/robinvdvleuten/pim-mcp:v0.1.0"
],
"env": {
"PIM_MCP_PASSWORD": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"pim": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PIM_MCP_PASSWORD",
"ghcr.io/robinvdvleuten/pim-mcp:v0.1.0"
],
"env": {
"PIM_MCP_PASSWORD": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"pim": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PIM_MCP_PASSWORD",
"ghcr.io/robinvdvleuten/pim-mcp:v0.1.0"
],
"env": {
"PIM_MCP_PASSWORD": "your-value"
}
}
}
}PIM_MCP_PASSWORD secreto obligatorio envPIM_MCP_READ_ONLY envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub robinvdvleuten, dueña del repo
Último cambio de código: hace 7 días
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
No revisado: solo se pueden revisar paquetes npm y PyPI con versión
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/robinvdvleuten-pim-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: PIM_MCP_PASSWORD
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 7 días, y la última versión (0.1.0) llegó al registro hace 7 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Docker en tu computadora.
En la misma categoría: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| Este pim-mcp | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Se instala en tu equipo |
| Necesita clave | Sí | No | No | Sí | No | No |
| Se añade con + en Claude | No | No | No | No | Sí | No |
| Revisiones básicas | 3/3 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| Licencia | MIT | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
PIM is short for personal information manager, the kind of app that keeps your mail and calendar together. pim-mcp lets an AI agent read your mail and manage your calendar on your own servers, with one login. The agent can find the meeting in an email and put it in your calendar in one step, with recurrence and time zones intact. It's built on the assumption that agents make mistakes and that invites come from strangers: your password stays in your keychain, your mail can't be changed, and a stale write can't overwrite an edit you just made on your phone.
--read-only removes every tool that can change something, so the agent can't call them at all.You: Add the meeting from Jan's last email to my calendar.
Agent: mail_search → "Project kickoff", from Jan, has a calendar invite calendar_preview_import → create "Kickoff, phase 1", 15 Jan 09:00–10:00, weekly, overlaps nothing "This adds a weekly meeting from 15 January. Shall I?"
You: Yes.
Agent: calendar_import_from_email → created
Early days. Reading mail and calendars has been tried on one real provider. Creating, changing and importing events have only run against the test servers above, so start with
--read-only.
You need an MCP client such as Claude Code.
1. Install it with Homebrew:
brew install --cask robinvdvleuten/tap/pim-mcp
Each release also has archives for macOS, Linux and Windows, and .deb, .rpm and .apk packages. To run it in Docker instead, see Docker.
2. Add your account. It shows the servers it found and asks before your password goes there. If your provider has app passwords, use one. To add another account later, run the same command with its address. The first account you add is the default.
pim-mcp account add --email you@example.org
3. Check that it can log in:
pim-mcp account test
imap: ok
caldav: ok
4. Connect your MCP client, read-only to begin with. For Claude Code:
claude mcp add pim -- "$(command -v pim-mcp)" serve --read-only
5. Ask your agent something like "What's on my calendar next week?"
When you're happy with what it does, add the server again without --read-only to allow changes.
The image is ghcr.io/robinvdvleuten/pim-mcp. A container has no keychain, so the password comes from PIM_MCP_PASSWORD, which limits you to one account. The account settings live in a folder on your machine that each container mounts.
Put the password in your shell without it going into your history:
read -rs PIM_MCP_PASSWORD && export PIM_MCP_PASSWORD
Add the account and check it:
docker run -it --rm -e PIM_MCP_PASSWORD -v "$HOME/.config/pim-mcp:/home/nonroot/.config/pim-mcp" ghcr.io/robinvdvleuten/pim-mcp account add --email you@example.org
docker run --rm -e PIM_MCP_PASSWORD -v "$HOME/.config/pim-mcp:/home/nonroot/.config/pim-mcp" ghcr.io/robinvdvleuten/pim-mcp account test
Connect Claude Code. This stores the password in Claude Code's own settings:
claude mcp add pim -e PIM_MCP_PASSWORD="$PIM_MCP_PASSWORD" -- docker run -i --rm -e PIM_MCP_PASSWORD -v "$HOME/.config/pim-mcp:/home/nonroot/.config/pim-mcp" ghcr.io/robinvdvleuten/pim-mcp serve --read-only
The container runs as user 65532. On Linux without Docker Desktop, that user needs to own the folder: sudo chown 65532 ~/.config/pim-mcp.
With Go, which downloads the exact version this project needs by itself:
go install github.com/robinvdvleuten/pim-mcp/cmd/pim-mcp@latest
| Tool | What it does | Read-only mode |
|---|---|---|
account_info | Shows an account, its servers and your time zone, and lists your accounts | ✓ |
mail_list_folders | Lists mail folders and their roles | ✓ |
mail_search | Searches a folder by sender, subject, text, date, or whether it holds an invite | ✓ |
mail_get | Reads a message: headers, text (HTML is turned into text) and a list of its parts, or the text of one part | ✓ |
calendar_list_calendars | Lists calendars | ✓ |
calendar_list_events | Lists events in a range, with recurring events expanded | ✓ |
calendar_free_busy | Finds when you're busy | ✓ |
calendar_preview_import | Shows what importing an invite would do, and writes nothing | ✓ |
calendar_create_event | Creates an event, optionally recurring from an RRULE | |
calendar_update_event | Changes an event, or one occurrence of a recurring one | |
calendar_delete_event | Deletes an event, or one occurrence of a recurring one | |
calendar_import_from_email | Adds, updates or cancels an event from an invite |
Mail is always read-only: no tool sends, moves, flags or deletes a message, and reading leaves it unread.
Every tool takes an optional account, the email address of the account to use. Leave it out and the default account is used. An id from mail_search, calendar_list_calendars or calendar_list_events belongs to the account that returned it, so the agent passes the same account again.
Your password
0600 in a 0700 directory).--password flag, so it can't end up in your shell history or process list. A CalDAV URL containing a password is refused.Your connections
Your data
What strangers send you
Invites and mail are treated as hostile input:
What it can't protect you from
Prompt injection is still possible. An email can try to talk your agent into something, and a warning in a tool description is no guarantee. An agent with these tools can read all your mail, and, unless read-only, change or delete calendar events. Your defences are
--read-only,--tools, and an MCP client that asks before calling tools that write.
Finding servers. account add tries built-in settings for mailbox.org, Fastmail and Posteo, then DNS, then the well-known locations providers publish. To skip this, name the servers yourself:
pim-mcp account add --email you@example.org --username you --imap mail.example.org:993 --caldav https://dav.example.org/
One lookup, Mozilla's ISPDB, tells Mozilla your email domain. --no-ispdb turns it off. Your full address is never sent during discovery.
Choosing tools. serve --tools mail_search,mail_get offers only those tools. Read-only mode still applies on top.
Environment variables:
| Variable | Effect |
|---|---|
PIM_MCP_PASSWORD | Uses this password instead of the keychain, for Docker and CI. Only works with a single account; with several it is an error |
PIM_MCP_READ_ONLY=1 | Same as --read-only |
PIM_MCP_DEBUG=1 | Logs each request to stderr: the tool and how long it took, never its arguments or results |
Other commands are account show, which lists the accounts and marks the default, account test [--email ADDRESS], account remove [--email ADDRESS] (--email is needed when you have several) and account default --email ADDRESS, which makes an account the default.
account that gave it a message, calendar or event id. A wrong pairing is usually refused, but that is not guaranteed, so it can read or list the wrong account.FREQ=WEEKLY;BYDAY=MO, and a timed one needs a time zone. Editing covers a whole series or a single occurrence, not "this and following", and a series' rule can't be changed after it is created.Install mise, which fetches the pinned Go, linter and Vale, then set up the commit hook:
mise install && mise run setup
Check a change: formatting, unit tests, lint and known vulnerabilities.
mise run check
Integration tests need Docker. This starts fresh test servers, runs the suite and removes them:
mise run integration
Set PIM_MCP_TEST_NEXTCLOUD=1 to include Nextcloud, and PIM_MCP_TEST_STACK=1 to run a second stack beside t