Zohobooks MCP Server

Zoho图书MCP服务器

通过模型上下文协议（MCP）将您的Zoho Books帐户连接到Claude Desktop等人工智能助手。

快速开始

1.获取Zoho API证书

1. 首选 Zoho API控制台
2. 创建“基于服务器的应用程序”
3. 添加重定向URI: http://localhost:8099/callback
4. 选择范围： ZohoBooks.fullaccess.all
5. 保存您的客户端ID、客户端密码和组织ID

2.通过uvx安装

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "zoho-books": {
      "command": "uvx",
      "args": ["zoho-books-mcp"],
      "env": {
        "ZOHO_CLIENT_ID": "your_client_id",
        "ZOHO_CLIENT_SECRET": "your_client_secret",
        "ZOHO_REFRESH_TOKEN": "your_refresh_token",
        "ZOHO_ORGANIZATION_ID": "your_organization_id",
        "ZOHO_REGION": "US"
      }
    }
  }
}

要获取刷新令牌，请执行以下操作： uvx zoho-books-mcp --setup-oauth

3.重新启动克劳德桌面

寻找🔌 图标以验证连接。

地方发展

# Clone and setup
git clone https://github.com/kkeeling/zoho-mcp.git
cd zoho-mcp
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

# Run tests
pytest

# Run server
python server.py

对于Claude Desktop中的本地开发：

{
  "mcpServers": {
    "zoho-books": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/zoho-mcp/server.py"],
      "env": {
        "ZOHO_CLIENT_ID": "your_client_id",
        "ZOHO_CLIENT_SECRET": "your_client_secret",
        "ZOHO_REFRESH_TOKEN": "your_refresh_token",
        "ZOHO_ORGANIZATION_ID": "your_organization_id",
        "ZOHO_REGION": "US"
      }
    }
  }
}

可用特征

工具

发票：创建语音、电子邮件语音、记录支付、发送支付提醒、作废语音、列表语音、获取语音、标记语音发送

联系人：create_customer、create_vender、update_contact、delete_contact，email_statement，list_contacts，get_contact

开支：创建费用、更新费用、分类费用、上传费用、列表费用、获取费用

物品：创建项、更新项、列表项、获取项

销售订单：创建销售订单、更新销售订单、转换发票、列表销售订单、获取销售订单

资源

• dashboard://summary -业务指标概述
• invoice://overdue -逾期发票清单
• invoice://unpaid -未付发票
• payment://recent -最近付款
• contact://list -所有联系人
• expenses://summary -费用概述

提示

• 发票收集工作流 -完成发票到付款周期
• 每月发音 -批量发票创建
• 费用跟踪工作流程 -费用记录和分类

配置

区域

• 美国（zoho.com）、欧盟（zoho.EU）、印度（zoho.IN）、澳大利亚（zoho.com.AU）、日本（zoho.JP）、英国（zoho.UK）、加拿大（zoho.CA）

故障排除

• 工具未显示：完全重新启动克劳德桌面
• 认证错误：使用重新生成刷新令牌 uvx zoho-books-mcp --setup-oauth
• 模块错误：确保虚拟环境已激活

开发与发布

创建发布

要将新版本发布到PyPI并创建GitHub版本，请执行以下操作：

1. 更新版本 在……里面 pyproject.toml
2. 更新CHANGELOG.md 附发行说明
3. 创建并推送一个git标签:

   git tag v0.1.0
   git push origin v0.1.0

1. 遵循手动发布步骤 在……里面 PUBLISHING.md 构建、上传到PyPI并创建GitHub版本

出版的先决条件

• 带有API令牌的PyPI帐户
• GitHub命令行界面(gh)已安装并验证
• 构建工具： pip install --upgrade pip build twine

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。#� �z�o�h�o�b�o�o�k�s�-�m�c�p�-�s�e�r�v�e�r� � �#� �z�o�h�o�b�o�o�k�s�-�m�c�p�-�s�e�r�v�e�r� � �