在Hermes Agent中接入Composio实现500+外部服务集成

前言

最近在使用 Hermes Agent时，发现它虽然功能强大，但默认无法直接访问 Outlook、Gmail、Notion 这类外部服务

每次想让 AI 帮我查个日程或者读封邮件，都得手动操作后再告诉它，或者手动一个个配置 MCP 或者 CLI，显得非常繁琐

后来发现了 Composio 这个平台——它通过 MCP（Model Context Protocol）协议，为 AI Agent 提供了 500+ 外部服务的统一接入能力。接上之后，AI 助手就能直接操作我的 Outlook 日历、读写邮件，甚至管理 Notion 页面

这篇文章记录了整个接入过程，包括遇到的坑和解决方案

什么是 Composio 和 MCP

MCP（Model Context Protocol）

MCP 是 Anthropic 提出的一个开放协议，用于标准化 AI 模型与外部工具/数据源之间的通信。你可以把它理解为 AI 世界的”USB 接口”——任何支持 MCP 的 AI 应用，都可以通过统一的方式连接到各种外部服务

Composio

Composio 是一个 MCP 服务提供商，它把 500+ 外部应用（Gmail、Outlook、Slack、GitHub、Notion、Salesforce 等）封装成了 MCP 工具。对于 AI Agent 来说，接入 Composio 就等于一次性获得了连接数百种服务的能力。

类别	数量	典型应用
开发工具	124	GitHub, GitLab, Supabase, Linear, Jira, Vercel
效率办公	147	Notion, Asana, Airtable, Google Tasks, Todoist
CRM	46	HubSpot, Salesforce, Pipedrive, Zoho CRM
沟通协作	55	Slack, Discord, Microsoft Teams, Gmail, Outlook
文档管理	76	Google Drive, Google Docs, Google Sheets, OneDrive
金融财务	52	Stripe, QuickBooks, Xero, Plaid
营销社交	98	Twitter/X, LinkedIn, Mailchimp, Meta Ads
电商	34	Shopify, WooCommerce, Amazon Seller
AI/ML	79	OpenAI, Anthropic, Hugging Face, Pinecone

配置过程

第一步：添加 Composio MCP 服务器

因为我使用的是 Windows 系统，并没有 Composio 的 CLI 适配，只能使用 MCP 来连接了

虽然 composio.dev/hermes 上写可以通过 Hermes 的 Agent 模式来自动配置，但是其实还是有很多问题的，一直报错返回多花了我近 100k 的 token

所以最好的方法还是手动先配置一下然后再用 Agent 检查

所以，应该先在命令行执行：

1	hermes mcp add composio --url https://connect.composio.dev/mcp --auth oauth

理论上执行完后，打开 config.yaml，可以看见以下的内容

mcp_servers:
  blender:
    command: uv
    args:
      - --directory
      - D:\Program\blender_mcp\mcp
      - run
      - blender-mcp
  composio:
    url: https://connect.composio.dev/mcp
    enabled: true
    auth: oauth

（Blender 那部分可以不用管，只是表明一下 MCP 配置的结构）

如果发现不对的话大概需要再手动编辑一下

第二步：验证连接

1	hermes mcp test composio

如果一切正常，你会看到类似这样的输出：

1 2	Connection: ✓ (10.7s) Tools: 7/7 enabled

第三步：重启会话使工具生效

MCP 工具添加后，需要在新会话中才能使用。在 Hermes TUI 中执行 /reset，或者启动一个新的 hermes chat 会话。

重启后，应该能看到 7 个 Composio 工具：

工具名	用途
`COMPOSIO_SEARCH_TOOLS`	搜索 500+ 应用集成
`COMPOSIO_MANAGE_CONNECTIONS`	管理应用连接（OAuth 授权）
`COMPOSIO_MULTI_EXECUTE_TOOL`	并行执行多个工具调用
`COMPOSIO_GET_TOOL_SCHEMAS`	获取工具的参数定义
`COMPOSIO_REMOTE_BASH_TOOL`	远程沙箱执行命令
`COMPOSIO_REMOTE_WORKBENCH`	批量工具执行和远程文件处理
`COMPOSIO_WAIT_FOR_CONNECTIONS`	等待 OAuth 授权完成

第四步：连接你的应用

Composio 接入后，登录获取 OAuth 授权

在 Hermes 对话中直接告诉 AI：

“帮我使用 Composio 读取我最新的 Outlook 邮件”

这时候，如果没有登录成功的话，Agent 应该会自动打开一个浏览器，登录你的 Composio 账号，点击连接授权，就可以正常使用了

另外，其实我还在 hermes 的 .env 的最后面加了一行

1	MCP_COMPOSIO_API_KEY=ck_xxxxxxxxxxxxxxx

我不知道是不是需要加的，如果还是连不上的话可以试试加上这一行

实际效果演示

接入完成后，AI 助手可以直接操作你的外部服务。以下是几个实际使用场景：

查看 Outlook 日程

直接对 AI 说”查看我最近的日程”，AI 会：

调用 COMPOSIO_SEARCH_TOOLS 搜索日历相关工具
使用 OUTLOOK_GET_CALENDAR_VIEW 获取日程数据
将结果整理成表格返回

效果如下：

📅 即将到来的日程

| 日期       | 时间       | 事项                | 地点               |
|-----------|-----------|--------------------|--------------------|
| 7月13日    | 10:00-15:00 | 模拟选课（试选）     | 选课系统        |
| 7月20日    | 10:00-13:00 | 正式选课第一轮       | 选课系统        |
| 7月20日    | 15:00-18:00 | 正式选课第二轮       | 选课系统        |