Less Annoying CRM

本地服务

github.com商业与营销01 天前更新

代码仓库访问官网

关于 Less Annoying CRM

这是一个供 AI 助手访问 Less Annoying CRM 的非官方 MCP 服务，可搜索联系人、读取备注、任务和销售管道，也可选择执行有限写入。它提供只读模式，并通过环境变量读取 API 密钥。

主要功能

01搜索联系人和公司
02读取联系人备注与任务
03查看销售管道及项目
04创建联系人、备注和任务
05更新销售管道项目状态
06只读模式隐藏写入工具

适用场景

01查询特定公司相关联系人
02查看本周到期的任务
03为联系人添加备注或任务
04调整销售管道项目状态

MCP 相关

通过 MCP stdio 向客户端提供 10 个 Less Annoying CRM 工具；只读模式下不注册 4 个写入工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "com-northkeellabs-lacrm": {
      "command": "uvx",
      "args": [
        "lacrm-mcp"
      ],
      "env": {
        "LACRM_API_KEY": "<LACRM_API_KEY>",
        "LACRM_READ_ONLY": "<LACRM_READ_ONLY>"
      }
    }
  }
}

启动命令uvx lacrm-mcp

需要配置的环境变量

LACRM_API_KEY密钥Less Annoying CRM API key (Settings > Programmer API)

LACRM_READ_ONLYSet to 1 to disable the write tools

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypilacrm-mcp0.1.1stdio

工具

收录的工具列表 · 更新于 3 天前

参数	类型	必填	说明
page	integer	否	页码，从 1 开始
query	any	否	要在联系人／公司字段中搜索的文本。省略则列出最近的记录。
sort_by	enum	否	Relevance \| FirstName \| LastName \| CompanyName \| DateCreated \| LastUpdate
max_results	integer	否	每页结果数（1-50）
record_type	any	否	限定为个人或公司

详细介绍

lacrm-mcp

一个 MCP（Model Context Protocol）服务，可让 Claude 等 AI 助手使用 Less Annoying CRM 账户：搜索联系人、读取备注和任务、查看销售流程，以及（可选）添加备注、任务和联系人，或移动销售流程项目。

独立的非官方项目。 lacrm-mcp 由 Northkeel Labs 根据 LACRM 的公开 API v2 文档构建。它与 Less Annoying CRM 无关联，也未获得其认可或支持。“Less Annoying CRM” 和“LACRM”是各自所有者的名称，仅用于描述兼容性。

60 秒快速入门

在 LACRM 中前往 Settings > Programmer API，然后创建 API 密钥。仅授予所需的权限（六个只读工具只需读取权限）。
安装 uv。首次运行时，uvx 会从 PyPI 获取 lacrm-mcp（或者使用 pip install lacrm-mcp）。

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "lacrm": {
      "command": "uvx",
      "args": ["lacrm-mcp", "--read-only"],
      "env": { "LACRM_API_KEY": "your-api-key" }
    }
  }
}

Claude Code：

claude mcp add lacrm --env LACRM_API_KEY=your-api-key -- uvx lacrm-mcp --read-only

需要使用写入工具时，移除 --read-only。然后可以这样提问：“查找 Acme 的联系人并显示他们最新的备注”，或“本周有哪些任务到期？”

工具

工具	LACRM 函数	写入？
`search_contacts`	GetContacts	否
`get_contact`	GetContact	否
`list_contact_notes`	GetNotesAttachedToContact	否
`list_tasks`	GetTasks	否
`list_pipelines`	GetPipelines	否
`list_pipeline_items`	GetPipelineItems	否
`create_contact`	CreateContact（加上用于默认所有者的 GetUser）	是
`add_note`	CreateNote	是
`create_task`	CreateTask	是
`update_pipeline_item_status`	EditPipelineItem	是

没有删除工具。列表工具每页最多返回 50 条结果，并报告 has_more_results；较长的文本字段会截断至 2,000 个字符。

**已于 2026-11-10 在一个真实的 Less Annoying CRM 账户上测试：**通过真实的 MCP stdio 连接，在正常模式和只读模式下测试了全部 10 个工具。

只读模式

设置 LACRM_READ_ONLY=1 或传入 --read-only。此时根本不会注册四个写入工具（模型看不到它们），并且会进行第二次检查，拒绝任何意外发出的写入调用。搭配只读 API 密钥使用，可增强纵深防御。

配置

变量	默认值	含义
`LACRM_API_KEY`	必填	API 密钥；仅从环境中读取
`LACRM_READ_ONLY`	关闭	`1`/`true` 会禁用写入工具
`LACRM_TIMEOUT_SECONDS`	20	每个请求的超时时间（1-120）
`LACRM_MAX_RETRIES`	3	对 429 的重试次数（仅读取操作还会对 5xx/超时重试）；0-6

与 LACRM 的通信方式

根据 API v2 文档，向 https://api.lessannoyingcrm.com/v2/ 发送 POST 请求，携带 Authorization: <key> 标头和 JSON 正文 {"Function": "...", "Parameters": {...}}。HTTP 400 响应包含 ErrorCode 和错误说明，相关信息会显示出来（并对机密信息进行遮盖）。文档未说明速率限制，因此遇到 HTTP 429 时，客户端会采用指数退避进行重试（如果收到 Retry-After，则遵循其值，最长不超过 30 s），并在最终错误中报告等待时间。为避免重复创建记录，写入操作遇到 5xx 或超时绝不会重试。

安全说明

请参阅 SECURITY.md。简而言之：CRM 文本是提供给模型的不可信输入，因此结果有大小限制，并会标记为数据；写入权限需主动启用且范围有限；密钥不会离开环境，也不会出现在日志或错误中。在客户端中批准写入操作之前，请先检查助手提出的内容。

开发

uv sync --extra dev      # or: python -m venv .venv && pip install -e '.[dev]'
uv run pytest            # all HTTP is mocked; no network or API key needed

需要 Python 3.11+ 和 MCP Python SDK 1.x（mcp<2，其中提供 FastMCP）。