Integrates with EspoCRM to provide complete CRUD operations for contacts, accounts, and opportunities with advanced search, filtering, pagination, and health monitoring capabilities.
Log in to your EspoCRM instance as an administrator
Open your EspoCRM web interface at your unique domain (e.g., https://your-espocrm-instance.com
).
Enable API access (if not already enabled)
- Go to Administration → Users.
- Edit (or create) the user that will be used for API access.
- Make sure the user has API access enabled and required permissions for the entities/tools you want to use.
Generate an API Key for EspoCRM
- In your EspoCRM instance, navigate to Preferences or Profile (usually top right, under the user's name).
- Look for a tab or section named API Keys (sometimes called "Portal Keys" or similar).
- Click Add Key or Generate API Key.
- Copy the generated API Key (it will only be shown once!).
(Optional: For HMAC Authentication)
- If you wish to use HMAC authentication instead of an API Key, generate a Secret Key and note it down.
Fill in the required FastMCP connection fields
Go to the FastMCP connection interface and fill in the following environment variables using your EspoCRM credentials:
ESPOCRM_URL
: Your EspoCRM instance URL (e.g., https://your-espocrm-instance.com
)
ESPOCRM_API_KEY
: The API key you generated
ESPOCRM_AUTH_METHOD
: Set to apikey
(or hmac
if using HMAC and secret key)
ESPOCRM_SECRET_KEY
: (Only needed for HMAC, leave blank for API Key method)
Complete the connection
- Click the "Install Now" button or equivalent in FastMCP to finish adding your EspoCRM ENVs.
Tip: Always keep your API key and secret key secure. Remove or rotate credentials if compromised.
You’re now set to use the EspoCRM MCP server with FastMCP!