谷歌服务管理工具

Googlellama

Googlellama是一个异步MCP（模块化命令处理）服务器，用于管理 Gmail、谷歌日历、联系人和任务 通过谷歌API。
它提供了一组即用型MCP工具，可以通过编程或LLM的提示调用。

该库专为自动化、批处理和智能集成而设计，允许您高效地清理收件箱、管理事件、更新联系人和自动化任务。

特性

Gmail工具

• clean_up_inbox --批量清理并存档您的收件箱。
• clean_up_archive --删除旧的或不需要的存档邮件。
• add_sender_to_delete_list / add_sender_to_archive_list --管理发件人筛选器。
• gmail_list --列出带有元数据（主题、发件人、日期）的电子邮件。
• delete_multiple_emails --按查询批量删除电子邮件。
• gmail_send --以编程方式发送电子邮件。
• gmail_modify --在邮件中添加或删除标签。
• gmail_delete / gmail_archive --删除或存档单个邮件。

谷歌日历工具

• calendar_list --列出指定时间范围内即将发生的事件。
• calendar_add --创建新的日历事件。
• calendar_update --更新现有日历事件。
• calendar_delete --按ID删除日历事件。

联系人工具

• contacts_find_by_name / contacts_get_by_name --按姓名搜索联系人。
• contacts_create_contact --创建新联系人。
• contacts_update_contact --更新现有联系人。
• contacts_delete_contact --删除联系人。

谷歌任务工具

• tasks_find_by_title --按标题查找任务。
• tasks_list_tasklists --列出所有任务列表。
• tasks_list --从默认任务列表中列出任务。
• tasks_add --添加新任务。
• tasks_update_by_title --按标题更新任务。
• tasks_delete --按ID删除任务。

安装

在可编辑模式下全局安装（不需要虚拟环境）：

# Exit any virtual environment first
deactivate  # if inside a venv

# Install
pip install --user -e .

确保你的路径包括 ~/.local/bin （Linux/macOS）：

export PATH="$HOME/.local/bin:$PATH"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

验证安装：

which Googlellama
Googlellama --help

使用示例

Googlellama旨在用于MCP集成，通常通过与MCP工具交互的LLM或脚本调用。

LLM/快速集成

此MCP服务器旨在通过LLM调用。
您可以创建如下提示：

• “清除删除列表中发件人的所有电子邮件”
• “向Bob发送一封主题为“提醒”和正文为“别忘了会议！”的电子邮件！”
• “列出我下周即将举行的日历活动”
• “使用电子邮件创建新联系人Alice Smithalice@example.com"

配置

1. 将您的Google API证书放入 data/credentials.json.
2. OAuth令牌将存储在 data/token.json 在第一次授权之后。
3. 用于删除/存档电子邮件的过滤器存储在：
   • data/delete_filter.txt
   • data/archive_filter.txt

发展

可编辑的安装允许即时测试：

pip install --user -e .

Python源文件的所有更改都可以立即使用，无需重新安装。

需求

• Python>=3.10
• requests, google-api-python-client, google-auth-oauthlib, fastapi, mcp, dotenv等等。（通过pip自动安装）。

许可证

麻省理工学院许可证©Akinus21