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"
______________________________________________________________________
配置
- 将您的Google API证书放入
data/credentials.json. - OAuth令牌将存储在
data/token.json在第一次授权之后。 - 用于删除/存档电子邮件的过滤器存储在：
- 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
______________________________________________________________________