联系人管理服务器

GoHighLevel MCP服务器是一个用于管理GoHighLevel CRM中联系人的模型上下文协议服务器,支持完整的CRUD、upsert、列表和搜索操作。

  • by NimbleBrainInc
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 NimbleBrainInc/mcp-gohighlevel

使用说明

GoHighLevel MCP服务器

用于管理GoHighLevel CRM中联系人的MCP(模型上下文协议)服务器。支持完整的CRUD、追加、列表和搜索操作。

特性

  • 获取、创建、更新、删除联系人
  • 具有重复检测功能的中断触点
  • 使用筛选器列出和搜索联系人
  • 异步HTTP客户端,具有错误处理功能
  • 使用Pydantic模型键入响应

安装

使用mpak(推荐)

# Configure your API key
mpak config set @nimblebraininc/gohighlevel api_key=your_api_key_here

# Run the server
mpak run @nimblebraininc/gohighlevel

手动安装

# Clone the repository
git clone https://github.com/NimbleBrainInc/mcp-gohighlevel.git
cd mcp-gohighlevel

# Install dependencies with uv
uv sync

# Set your API key
export GOHIGHLEVEL_API_KEY=your_api_key_here

# Run the server
uv run python -m mcp_gohighlevel.server

配置

获取API密钥

使用一个 私有集成令牌 或 OAuth访问令牌 从您的GoHighLevel帐户。看 GoHighLevel API文档 有关设置说明。

Claude桌面配置

添加到您的 ~/.claude/settings.json:

{
  "mcpServers": {
    "gohighlevel": {
      "command": "mpak",
      "args": ["run", "@nimblebraininc/gohighlevel"]
    }
  }
}

可用工具

工具 说明
get_contact 通过ID获取单个联系人
create_contact 创建新联系人
update_contact 更新现有联系人
delete_contact 按ID删除联系人
upsert_contact 基于重复设置创建或更新联系人
list_contacts 列出某个位置的联系人(已弃用)
search_contacts 使用高级筛选器搜索联系人

发展

# Install dev dependencies
uv sync --dev

# Run tests
uv run pytest tests/ -v

# Format code
uv run ruff format src/ tests/

# Lint
uv run ruff check src/ tests/

# Type check
uv run ty check src/

# Run all checks
make check

许可证

麻省理工学院