Server Configuration
Describes the environment variables required to run the server.
Name | Required | Description | Default |
---|---|---|---|
LOG_LEVEL | No | Optional pino log level (fatal|error|warn|info|debug|trace|silent) | info |
MONICA_BASE_URL | No | The base URL of your Monica CRM instance (defaults to https://app.monicahq.com; change for self-hosted instances) | https://app.monicahq.com |
MONICA_API_TOKEN | Yes | Your Monica CRM API token | |
MONICA_TOKEN_TYPE | No | The type of token authentication to use (one of: bearer (default), apiKey, legacy) | bearer |
MONICA_USER_TOKEN | No | Required only when MONICA_TOKEN_TYPE=legacy |
Schema
Prompts
Interactive templates invoked by user choice
Name | Description |
---|---|
No prompts |
Resources
Contextual data attached and managed by the client
Name | Description |
---|---|
No resources |
Tools
Functions exposed to the LLM to take actions
Name | Description |
---|---|
monica_search_contacts | Search Monica CRM contacts by name, nickname, or email. Returns contact IDs and basic info. Use the returned ID with other tools to get details or make updates. |
monica_get_contact_summary | Retrieve full profile details for a specific contact ID. Use this after searching to see complete contact information before making updates. DEPENDENCY: Requires contactId - use monica_search_contacts to find existing contacts or monica_manage_contact with action="create" to create a new contact first. |
monica_create_note | Attach a note to a Monica contact. |
monica_manage_activity | Manage activities (meetings, calls, events) in Monica CRM. Use this to track interactions and shared experiences with contacts. |
monica_manage_address | Manage physical addresses for contacts. Use this to add home, work, or other addresses to contact profiles. DEPENDENCY: For create/update actions, requires contactId - use monica_search_contacts to find existing contacts or monica_manage_contact with action="create" to create a new contact first. |
monica_lookup_country | Retrieve the supported country catalog (name, ISO code, Monica ID). Use this before creating or updating addresses so you can map human-friendly names to the correct country identifier. |
monica_lookup_gender | Fetch the gender catalog so you can supply the correct genderId when creating or updating contacts. Monica requires a genderId for every contact profile. |
monica_manage_relationship | List, inspect, create, update, or delete relationships between contacts. Use this to confirm existing connections or link two contacts once you know the correct relationshipTypeId. |
monica_manage_activity_type | List, inspect, create, update, or delete Monica activity types. |
monica_manage_activity_type_category | List, inspect, create, update, or delete activity type categories. |
monica_manage_task | List, inspect, create, update, or delete tasks. Use this to add follow-ups, mark them complete, or target them to another contact. |
monica_manage_note | List, inspect, create, update, or delete notes attached to a contact. Use this to capture or revise journal snippets. |
monica_manage_contact_field_type | ADVANCED: Manage the types/categories of contact fields (like "Mobile Phone", "Work Email"). Most users should use monica_manage_contact_field directly instead. Use this only to create new field types or see available options. |
monica_manage_contact_field | PREFERRED FOR PHONES/EMAILS: Add, update, or remove phone numbers, emails, and other contact information. Also handles custom fields like social media handles. Use this instead of basic contact management for communication details. DEPENDENCY: For create action, requires contactId (use monica_manage_contact with action="create") and contactFieldTypeId (use monica_manage_contact_field_type with action="list" or "create"). |
monica_manage_contact | Create, update, or delete contacts in Monica CRM. Use this for basic profile info (name, gender, description, birthdate). For phone numbers and emails, use contact field management instead. |
monica_list_tasks | List tasks across Monica CRM or for a specific contact. |
monica_manage_relationship_type | List, inspect, create, update, or delete relationship types. Use this to manage the catalog of relationship types (like "Father", "Friend", "Colleague") that can be used when creating relationships between contacts. |
monica_manage_group | List, inspect, create, update, or delete contact groups. Use this to organize contacts into named collections (e.g., "Family", "Travel buddies"). |
monica_manage_reminder | List, inspect, create, update, or delete reminders. Use this to schedule follow-ups or stay-in-touch nudges for specific contacts. |
monica_manage_relationship_type_group | List and inspect relationship type groups. These are system-defined categories (like "love", "family", "friend", "work") used to organize relationship types. Note: This endpoint is read-only. |
monica_manage_tag | List, inspect, create, update, or delete tags. Tags allow you to group and categorize contacts. |
monica_health_check | Verify that the configured Monica credentials work. |