Capsule CRM MCP server
Commit 13. Nov. 2026Verbinde Claude mit deinem Capsule CRM, um Kontakte, Opportunities, Projekte, Aufgaben und Timeline-Aktivitäten per natürlicher Sprache zu verwalten.
Auch bekannt als soil-dev/capsulemcp
- Stars
- 5
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 13. Nov. 2026
- Lizenz
- Apache-2.0
Was ist Capsule CRM MCP?
Verbinde Claude mit deinem Capsule CRM, um Kontakte, Opportunities, Projekte, Aufgaben und Timeline-Aktivitäten per natürlicher Sprache zu verwalten.
Zusammenfassung generiert aus dem README des Projekts
Über Capsule CRM MCP server
Das Verwalten von CRM-Daten durch natürliche Sprache ist das, was capsulemcp für Nutzer von Capsule CRM ermöglicht. Durch die Verbindung von Claude Desktop, Claude Code oder Web-Projekten via Custom Connector kannst du mit deinem gesamten Datensatz interagieren, einschließlich Kontakte, Organisationen, Opportunities, Projekte und Aufgaben. Der Server bietet 92 Tools, die eine tiefe Exploration deiner Daten ermöglichen – von einfachen Suchen bis hin zu komplexen Abfragen mit strukturierten Filtern und Bedingungen für Felder und Operatoren.
Entwickler können zwischen einer lokalen Installation via stdio oder einem Hosted-Setup via HTTP und OAuth wählen. Für alle, die Datensicherheit priorisieren, bietet der Server einen Read-Only-Modus über eine Umgebungsvariable sowie spezifische Tool-Annotationen, die destruktive Aktionen signalisieren. Er unterstützt zudem Batch-Operationen für Massen-Updates und ermöglicht die Verwaltung von Dateianhängen durch Read- und Write-Capabilities. Egal, ob du gelöschte Datensätze auditierst oder Workflow-Tracks verwaltest – dieser Connector schließt die Lücke zwischen deinem CRM und deinem KI-Assistenten.
Was du damit machen kannst
- 1Abfragen von CRM-DatensätzenBitte deinen KI-Assistenten, spezifische Kontakte oder Opportunities mithilfe natürlicher Sprache zu finden.
- 2Durchführung von Massen-UpdatesNutze Batch-Tools, um mehrere Datensätze gleichzeitig innerhalb deiner CRM-Workflows zu aktualisieren.
- 3Ausführen komplexer DatenfilterWende strukturierte Filter mit spezifischen Feld- und Operator-Bedingungen an, um deine CRM-Ergebnisse einzugrenzen.
- 4Verwalten von ProjektdateienVerwalte Dateianhänge, indem du Dateien direkt in deine CRM-Datensätze liest oder schreibst.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Konfiguration
CAPSULE_API_TOKENCAPSULE_MCP_READONLY
| Name | Beschreibung | Typ |
|---|---|---|
| CAPSULE_API_TOKEN | — | |
| CAPSULE_MCP_READONLY | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarsoil-dev/capsulemcp is public and reachablegithub.com/soil-dev/capsulemcp ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-13github.com/soil-dev/capsulemcp ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehencapsulemcp
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.
Capsule CRM MCP Fragen
Wie kann ich sicherstellen, dass der Server nur Leseoperationen durchführt?
Du kannst die Umgebungsvariable CAPSULE_MCP_READONLY auf 1 setzen, um alle Schreib- und Lösch-Tools auf der MCP-Ebene zu deaktivieren.
Wie installiere ich das lokal für Claude Desktop?
Für die lokale Installation fügst du ein JSON-Snippet zu deiner Claude Desktop Konfigurationsdatei hinzu, das npx nutzt, um das capsulemcp Package auszuführen.
Unterstützt der Server Batch-Updates?
Ja, es stehen 6 batched-write Tools für Massen-Update-Workflows zur Verfügung.
Wie wird verhindert, dass destruktive Aktionen versehentlich ausgeführt werden?
Destruktive Tools erfordern ein 'confirm: true' Argument. Zudem ist das System mit Read-Scoped Tokens und einem Read-Only-Modus-Flag für zusätzliche Sicherheit konzipiert.