MCP server de Capsule CRM
Commit 13 nov 2026Conecta Claude con tu Capsule CRM para gestionar contactos, oportunidades, proyectos, tareas y la actividad de la línea de tiempo mediante lenguaje natural.
También conocido como soil-dev/capsulemcp
- Stars
- 5
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 13 nov 2026
- Licencia
- Apache-2.0
¿Qué es Capsule CRM MCP?
Conecta Claude con tu Capsule CRM para gestionar contactos, oportunidades, proyectos, tareas y la actividad de la línea de tiempo mediante lenguaje natural.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Capsule CRM
Gestionar datos de CRM a través de conversaciones en lenguaje natural es lo que capsulemcp permite a los usuarios de Capsule CRM. Al conectar Claude Desktop, Claude Code o proyectos web mediante un Custom Connector, puedes interactuar con todo tu grafo de registros, incluyendo contactos, organizaciones, oportunidades, proyectos y tareas. El servidor proporciona 92 herramientas que permiten una exploración profunda de tus datos, desde búsquedas simples hasta consultas complejas utilizando filtros estructurados con condiciones de campo y operador.
Los desarrolladores pueden elegir entre una instalación local usando stdio o una configuración alojada usando HTTP y OAuth. Para quienes priorizan la seguridad de los datos, el servidor incluye un modo de solo lectura mediante una variable de entorno y anotaciones de herramientas específicas que señalan acciones destructivas. También admite operaciones por lotes para actualizaciones masivas y permite la gestión de archivos adjuntos mediante capacidades de lectura y escritura. Ya sea que estés auditando registros eliminados o gestionando flujos de trabajo, este conector cierra la brecha entre tu CRM y tu asistente de IA.
Qué puedes hacer con él
- 1Consultar registros del CRMPide a tu asistente de IA que encuentre contactos u oportunidades específicos usando preguntas en lenguaje natural.
- 2Realizar actualizaciones masivasUtiliza herramientas por lotes para actualizar múltiples registros a la vez dentro de tus flujos de trabajo de CRM.
- 3Ejecutar filtros de datos complejosAplica filtros estructurados con condiciones específicas de campo y operador para refinar tus resultados del CRM.
- 4Gestionar archivos de proyectosAdministra archivos adjuntos leyendo o escribiendo archivos directamente en tus registros de CRM.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Configuración
CAPSULE_API_TOKENCAPSULE_MCP_READONLY
| Nombre | Descripción | Tipo |
|---|---|---|
| CAPSULE_API_TOKEN | — | |
| CAPSULE_MCP_READONLY | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblesoil-dev/capsulemcp is public and reachablegithub.com/soil-dev/capsulemcp ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-13github.com/soil-dev/capsulemcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubcapsulemcp
A Model Context Protocol server for Capsule CRM. Connect Claude (Desktop, Code, or web Projects via Custom Connector) to your CRM and let it answer natural-language questions across the full record graph: contacts, organisations, opportunities, projects, tasks, and timeline activity. Beyond the basics it covers structured filters with field/operator conditions, saved searches with sort, workflow tracks (templates and instances), file attachments (read + write), audit of deleted records, and batch fetches up to 50 records per call.
- 92 tools across the Capsule resource graph (53 in read-only mode) — full read coverage plus careful, confirm-gated writes; 6 batched-write tools (
batch_*) for mass-update workflows - Two transports: stdio for local installs (Claude Desktop / Code), HTTP+OAuth for hosted Custom Connectors — with an unauthenticated
GET /healthtoken-health page for uptime monitoring - Read-only mode as a one-env-var flag; works alongside read-scoped Capsule tokens
- MCP tool annotations: 53 read tools carry
readOnlyHint: true, 8 destructive ones carrydestructiveHint: true— clients that honor these hints can auto-approve safe reads while still prompting for writes/destructive calls - Apache 2.0
Pick your install
| You want | Read this |
|---|---|
| Example questions to ask once the connector is running | EXAMPLES.md |
| To use it locally with Claude Desktop or Claude Code | INSTALL.md |
| To deploy it once and have your whole team use it via Claude.ai | DEPLOY.md |
| To wire it into n8n workflows | INTEGRATIONS-n8n.md |
| To contribute, debug, add a tool, or cut a release | HOWTO.md (procedures) · CONTRIBUTING.md (style & PR checks) |
| To understand what's intentionally not implemented (and why) | DESIGN.md |
| To see what performance work has been done (and what's next) | OPTIMIZATIONS.md |
| To see ideas for features that might land in future versions | IDEAS.md |
| To learn the surprising parts of Capsule's v2 API (with verbatim doc quotes) | NOTES-ON-CAPSULE-API.md |
For most individual users the install is a single JSON snippet pasted into Claude Desktop's config — see INSTALL.md.
Quick start (Claude Desktop)
-
Generate a Capsule API token: My Preferences → API Authentication Tokens → Generate, choose the Read scope for safety.
-
Add this to your
claude_desktop_config.json(~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS):{ "mcpServers": { "capsule": { "command": "npx", "args": ["-y", "capsulemcp@2.5.0"], "env": { "CAPSULE_API_TOKEN": "<paste token here>", "CAPSULE_MCP_READONLY": "1" } } } } -
Restart Claude Desktop. The Capsule tools appear in the tool picker.
That's it. The first launch fetches the package from npm (a few seconds); subsequent launches are instant from the npx cache. The snippet pins an exact version on purpose: the connector runs with your Capsule token in its environment, so you should decide when new code runs with it — upgrade by changing the version after reading the release notes. Plain "capsulemcp" (unpinned) always runs the newest release instead; see INSTALL.md for the trade-off and how to verify a release's provenance. If you're tracking a fork or an unreleased branch, use the GitHub-ref form: "github:soil-dev/capsulemcp#v2.5.0" — same arguments, installs from a git clone rather than the npm registry. See INSTALL.md for the Claude Code path, manual install, and troubleshooting.
Tools
| Group | Read | Write |
|---|---|---|
| Parties (people/orgs) | search_parties, filter_parties, get_party, get_parties, list_employees, list_party_opportunities, list_party_projects, list_party_entries |
create_party, update_party, delete_party, add_party_email_address, remove_party_email_address_by_id, add_party_phone_number, remove_party_phone_number_by_id, add_party_address, remove_party_address_by_id, add_party_website, remove_party_website_by_id |
| Opportunities | search_opportunities, filter_opportunities, get_opportunity, get_opportunities, list_opportunity_entries, list_associated_projects |
create_opportunity, update_opportunity, delete_opportunity |
| Projects | search_projects, list_projects, filter_projects, get_project, get_projects, list_project_entries |
create_project, update_project, delete_project |
| Additional parties (multi-party deals) | list_additional_parties |
add_additional_party, remove_additional_party |
| Tasks | list_tasks, get_task, get_tasks |
create_task, update_task, complete_task, delete_task |
| Entries (notes / captured emails) | get_entry, list_entries |
add_note, update_entry, delete_entry |
| Attachments (file upload / download) | get_attachment |
upload_attachment |
| Activity feed (tenant-wide) | list_activities |
— |
| Audit (deleted records) | list_deleted_parties, list_deleted_opportunities, list_deleted_projects |
— |
| Pipelines & milestones (opportunities) | list_pipelines, list_milestones |
— |
| Boards & stages (projects) | list_boards, list_stages |
— |
| Tracks (workflow instances) | list_track_definitions, list_entity_tracks, get_track |
apply_track, update_track, remove_track |
| Saved filters | list_saved_filters, run_saved_filter |
— |
| Custom fields (schema) | list_custom_fields, get_custom_field |
— |
| Tags | list_tags |
add_tag, remove_tag_by_id, delete_tag_definition |
| Users & teams | list_users, get_current_user, list_teams |
— |
| Reference metadata | list_lost_reasons, list_activity_types, list_categories, list_goals, list_countries, list_currencies, get_site |
— |
Most record-list tools default perPage=25; reference-data tools default perPage=100 so small accounts usually fit in one response. All paginated tools cap perPage at 100 and return a nextPage cursor when more results exist. Many GET tools accept an embed parameter (e.g. tags,fields) — each tool's description enumerates its valid tokens (validated per resource; unknown tokens are rejected rather than silently ignored, and the caller-facing project token maps to Capsule's legacy kase on the wire).
The filter_* tools wrap Capsule's structured filter endpoint (POST /<entity>/filters/results) and accept an array of {field, operator, value} conditions ANDed together. Capsule's API does not support ad-hoc sort, so for "most recent X" questions filter by a date condition (e.g. addedOn is within last 7) and pick the highest id from the result — Capsule's numeric IDs are monotonically incrementing.
If you want sortable queries, use saved filters instead. Create the filter once in Capsule's web UI (it lets you set conditions, columns, and orderBy), then call run_saved_filter with its id. Use list_saved_filters to discover what's available.
Read-only mode
Set CAPSULE_MCP_READONLY=1 to disable every write/delete tool at the MCP layer (none of create_*, update_*, complete_task, add_note, or delete_* are registered). Pair it with a Capsule token that has the Read scope for defence in depth — your token's scope is the hard ceiling regardless of the env var.
Delete safety
Every whole-record delete_* tool, plus remove_track and remove_additional_party, requires confirm: true in its arguments. Without it, the schema rejects the call before any HTTP is made. Tool descriptions tell Claude to read the entity first and confirm with the user before invoking. The combined design — read-scoped token, read-only mode flag, schema-level confirm gate — means destructive actions are deliberate, not accidental.
License
Apache License 2.0 — Copyright 2026 Anton Arapov.
Preguntas sobre Capsule CRM MCP
¿Cómo puedo asegurarme de que el servidor solo realice operaciones de lectura?
Puedes establecer la variable de entorno CAPSULE_MCP_READONLY en 1 para desactivar todas las herramientas de escritura y eliminación en la capa de MCP.
¿Cómo lo instalo localmente para Claude Desktop?
Para la instalación local, añade un fragmento JSON a tu archivo de configuración de Claude Desktop usando npx para ejecutar el paquete capsulemcp.
¿El servidor admite actualizaciones por lotes?
Sí, hay 6 herramientas de escritura por lotes disponibles para flujos de trabajo de actualización masiva.
¿Cómo se evita que las acciones destructivas ocurran accidentalmente?
Las herramientas destructivas requieren un argumento 'confirm: true', y el sistema está diseñado con tokens de alcance de lectura y un flag de modo de solo lectura para ofrecer una defensa en profundidad.