heffl.com

Heffl is a CRM and business operations platform for managing contacts, companies, deals, tasks, quotations, projects, forms, and related workspace data. It also supports connecting AI assistants to a user's Heffl workspace via MCP.

4 integrations · MCP · REST

heffl.com exposes a small public discovery REST surface on the main site, two authenticated REST APIs at api.heffl.com (legacy v1 and current v2) using API keys, and an OAuth-protected MCP server at https://api.heffl.com/api/mcp.

discovered 2mo ago

MCP servers1

Heffl MCP serverdetectedstreamable-http

REST · OpenAPI3

Heffl REST API v1discoveredrest
Heffl REST API v2discoveredrest
Heffl Public API discovery endpointsdetectedrest

Credentials

Heffl API keyapi_keyGet key ↗

In the Heffl app, go to Settings → Developer and create an API key. The docs say API keys are team-scoped and act on behalf of the user who created them. Use the key in the x-api-key header for REST API requests.

Heffl user OAuth authorization for MCPoauth2Set up OAuth ↗

For the Heffl MCP server, you typically do not pre-create developer credentials. Add the MCP server URL in your MCP client, and the client should initiate OAuth automatically; you then sign in on Heffl’s own login page and approve access for a team. Docs for Claude/ChatGPT/Cursor instruct pasting https://api.heffl.com/api/mcp, signing in with your usual Heffl account, choosing a team, and clicking Authorize. The service advertises OAuth endpoints at login and token.

conventions · 4/8 published

integrations.json✗/.well-known/integrations.json
llms.txt✗/llms.txt
API catalog✓https://heffl.com/.well-known/api-catalog
OpenAPI document✓https://heffl.com/openapi.json
MCP server card✗/.well-known/mcp/server-card.json
OAuth protected resource✓https://heffl.com/.well-known/oauth-protected-resource
Agent card✗/.well-known/agent-card.json
Agent skills✓https://heffl.com/.well-known/agent-skills/index.json

Publish these signals → /publishing