Capsule CRM Automation
Automate Capsule CRM operations -- manage contacts (parties), run structured filter queries, track tasks and projects, log entries, and handle organizations -- using natural language through the Composio MCP integration.
- License 许可
- MIT
- 最近更新
- 2026-11-03
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- Capsule CRM Automation
- category
- crm
- requires
- { "mcp": [ "rube" ] }
- description
- Automate Capsule CRM operations -- manage contacts (parties), run structured filter queries, track tasks and projects, log entries, and handle organizations -- using natural language through the Composio MCP integration.
03 SKILL.md 正文
Capsule CRM Automation
Manage your Capsule CRM -- create and update contacts, run powerful filter queries on parties/opportunities/cases, track tasks and projects, browse activity entries, and organize team relationships -- all through natural language commands.
Toolkit docs: composio.dev/toolkits/capsule_crm
Setup
- Add the Composio MCP server to your client configuration:
https://rube.app/mcp - Connect your Capsule CRM account when prompted (OAuth authentication).
- Start issuing natural language commands to manage your CRM.
Core Workflows
1. Run Structured Filter Queries
Query parties, opportunities, or cases (projects) with multiple filter conditions, operators, and sorting.
Tool: CAPSULE_CRM_RUN_FILTER_QUERY
Example prompt:
"Find all Capsule CRM contacts in California tagged as 'VIP' sorted by name"
Key parameters:
entity(required) -- One of:parties,opportunities,kasesfilter(required) -- Filter object with:conditions-- Array of conditions, each with:field-- Field name (e.g., "name", "email", "state", "country", "tag", "owner", "jobTitle", "addedOn")operator-- One of: "is", "is not", "starts with", "ends with", "contains", "is greater than", "is less than", "is after", "is before", "is older than", "is within last", "is within next"value-- Value to compare against
orderBy-- Array of sort objects withfieldanddirection("ascending"/"descending")
embed-- Additional data to include in responsepage/perPage-- Pagination (max 100 per page)
Important field notes:
- Address fields (
city,state,country,zip) are top-level, NOT nested under "address" - Country must be an ISO 3166-1 alpha-2 code (e.g., "US", "GB", "CA")
- Custom fields use
custom:{fieldId}format - Organization fields use
org.prefix (e.g.,org.name,org.tag)
2. List and Manage Contacts (Parties)
Retrieve all contacts with optional filtering by modification date and embedded related data.
Tool: CAPSULE_CRM_LIST_PARTIES
Example prompt:
"List all Capsule CRM contacts modified since January 2025 with their tags and organizations"
Key parameters:
since-- ISO8601 date to filter contacts changed after this dateembed-- Additional data: "tags", "fields", "organisation", "missingImportantFields"page/perPage-- Pagination (max 100 per page, default 50)
3. Create New Contacts
Add people or organizations to your Capsule CRM with full details including emails, phones, addresses, tags, and custom fields.
Tool: CAPSULE_CRM_CREATE_PARTY
Example prompt:
"Create a new person in Capsule CRM: John Smith, VP of Sales at Acme Corp, john@acme.com"
Key parameters:
type(required) -- "person" or "organisation"- For persons:
firstName,lastName,jobTitle,title - For organisations:
name emailAddresses-- Array of{address, type}objectsphoneNumbers-- Array of{number, type}objectsaddresses-- Array of address objects withstreet,city,state,country,zip,type(Home/Postal/Office/Billing/Shipping)organisation-- Link to org by{id}or{name}(creates if not found)tags-- Array of tags by{name}or{id}fields-- Custom field values with{definition, value}websites-- Array of{address, service, type}objectsowner-- Assign owner user{id}
4. Update Existing Contacts
Modify any aspect of a party record including adding/removing emails, phones, tags, and custom fields.
Tool: CAPSULE_CRM_UPDATE_PARTY
Example prompt:
"Update Capsule CRM party 11587: add a work email john.new@acme.com and remove tag 'prospect'"
Key parameters:
partyId(required) -- Integer ID of the party to updateparty(required) -- Object with fields to update. Supports:- All creation fields (name, emails, phones, addresses, etc.)
_delete: trueon sub-items to remove them (requires the item'sid)- Tags: add by
{name}or remove with{id, _delete: true}
5. Track Tasks
List tasks with filtering by status and embedded related data.
Tool: CAPSULE_CRM_LIST_TASKS
Example prompt:
"Show all open tasks in Capsule CRM with their linked parties and owners"
Key parameters:
status-- Filter by status: "open", "completed", "pending" (array)embed-- Additional data: "party", "opportunity", "kase", "owner", "nextTask"page/perPage-- Pagination (max 100 per page, default 50)
6. Browse Projects and Activity Entries
List projects (cases) and recent activity entries including notes, emails, and completed tasks.
Tools: CAPSULE_CRM_LIST_PROJECTS, CAPSULE_CRM_LIST_ENTRIES_BY_DATE
Example prompt:
"Show all open projects in Capsule CRM" / "Show recent activity entries with party details"
Key parameters for projects:
status-- Filter by "OPEN" or "CLOSED"search-- Search term for project names/descriptionssince-- ISO8601 date for modifications after this dateembed-- "tags,fields,party,opportunity,missingImportantFields"
Key parameters for entries:
embed-- "party", "kase", "opportunity", "creator", "activityType"page/perPage-- Pagination (max 100 per page)
Known Pitfalls
- Address fields are top-level: When filtering, use
state,city,country,zipdirectly -- NOTaddress.stateor nested syntax. - Country codes are ISO alpha-2: Filter by "US", "GB", "CA" -- not "United States" or "United Kingdom".
- Custom fields use special syntax: Reference custom fields as
custom:{fieldId}in filter conditions. For org-level custom fields, useorg.custom:{fieldId}. - Projects are called "kases" in the API: Despite being "projects" in the UI, the API entity type is
kases. Usekasesin filter queries. - Delete operations require item IDs: When updating a party to remove sub-items (emails, phones, tags), you must include the item's
idalong with_delete: true. List the party first to get sub-item IDs. - Pagination defaults to 50: All list endpoints default to 50 items per page with a max of 100. Always implement pagination for complete data retrieval.
- Embed values vary by entity: Not all embed options work for all entities. Check the documentation for supported embed values per endpoint.
Quick Reference
| Action | Tool Slug | Required Params |
|---|---|---|
| Run filter query | CAPSULE_CRM_RUN_FILTER_QUERY |
entity, filter |
| List contacts | CAPSULE_CRM_LIST_PARTIES |
None (optional filters) |
| Create contact | CAPSULE_CRM_CREATE_PARTY |
type |
| Update contact | CAPSULE_CRM_UPDATE_PARTY |
partyId, party |
| Delete contact | CAPSULE_CRM_DELETE_PARTY |
party_id |
| List tasks | CAPSULE_CRM_LIST_TASKS |
None (optional filters) |
| List projects | CAPSULE_CRM_LIST_PROJECTS |
None (optional filters) |
| List activity entries | CAPSULE_CRM_LIST_ENTRIES_BY_DATE |
None (optional filters) |
| List org employees | CAPSULE_CRM_LIST_ORG_EMPLOYEES |
Organisation ID |
| List deleted opportunities | CAPSULE_CRM_LIST_DELETED_OPPORTUNITIES |
since |
Powered by Composio
04 同仓库更多 Skills
x-article-draft-uploader
把本地 Markdown 转为经核验的 X Articles 新草稿。适用于需要保留首图封面、正文图片相对位置,并在独立 Playwright 会话中复用用户已授权 Chrome 登录态的任务;不负责公开发布。
wecom-operations
通过用户已配置的官方 wecom-cli 管理企业微信文档、智能文档、待办、会议和日程。适合创建或查询这些云端对象、把本地 Markdown 转为智能文档,以及在明确确认后更新或取消对象;不发送消息、不控制桌面客户端。
wecom-local-vault
Inspect authorized local WeCom databases on macOS, create private plaintext snapshots, and query or export contacts, conversations, and messages without modifying the source account store. Use when the user asks to parse 企业微信/WeCom local data, recover a private database snapshot, inspect local contacts or sessions, search chat history, or export a bounded conversation.
wechat-reading
Read and analyze WeRead/微信读书 search results, book metadata, bookshelf entries, progress, notes, highlights, public reviews, recommendations, and reading statistics through the official read-only Agent Gateway. Use for WeRead account questions or exports; do not imply that the current Gateway can add, remove, upload, rate, like, or edit content.
wechat-mp-batch-exporter
Build a bounded, private archive from known WeChat Official Account article URLs or an owner-authorized account-history export, with explicit reconciliation of article, publish-group, and platform-marked-original counts. Use for batch body capture, history normalization, or enhanced metrics/comments workflows. Do not use for a one-page summary or to automate the WeChat client.
wechat-local-vault
在 macOS 本机建立并查询私有微信数据快照。适用于盘点数据库、离线校验已有密钥候选、创建全量或增量明文快照、查会话与联系人、按时间检索消息、导出指定聊天、查看朋友圈或收藏,以及准备群聊摘要素材。所有查询只读,默认隐藏内部账号标识,不操控微信界面,也不发送任何内容。