Xiaozhi Desktop MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ALLOWED_APPS | Yes | Comma-separated list of allowed macOS app names | |
| OBSIDIAN_VAULT | Yes | Path to your Obsidian vault | |
| CC_ALLOWED_PROJECTS | Yes | Comma-separated list of allowed project directories for Claude Code | |
| DEFAULT_PROJECT_ROOT | Yes | Default root directory for projects |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| obsidian_save_memoryC | 当用户说“记一下/保存想法/写到 Obsidian”时调用,保存一条语音记忆。 |
| obsidian_create_noteB | 新建 Obsidian vault 内的 Markdown 笔记。 |
| obsidian_open_noteC | 打开 Obsidian vault 内的 Markdown 笔记。 |
| obsidian_append_noteC | 追加内容到 Obsidian vault 内指定 Markdown 笔记。 |
| obsidian_append_daily_noteC | 追加内容到 Obsidian 每日笔记。 |
| obsidian_searchC | 搜索 Obsidian vault 内 Markdown 笔记,返回少量片段。 |
| obsidian_recent_memoriesC | 读取最近几条语音记忆。 |
| app_openA | 当用户说“打开某个 App”时调用;只允许打开配置白名单里的 macOS App。 |
| app_closeA | 当用户说“关闭某个 App”时调用;只允许关闭配置白名单里的 macOS App。 |
| cc_create_taskB | 当用户说“让 cc/Codex/Claude Code 做...”时调用,只创建待办任务,不执行命令。 |
| cc_start_sessionC | 启动受管 Claude Code/Codex CLI 会话;只能在配置允许的项目目录里启动。 |
| cc_open_visible_sessionB | 打开可见 Terminal/iTerm 窗口并启动 Claude Code/Codex;方便人工观看和接管。 |
| cc_open_claude_codeC | 当用户说“打开 Claude Code/打开 cc”时调用,默认在可见 Terminal 中启动 claude。 |
| cc_list_sessionsA | 列出当前服务进程记住的可见 Claude Code/Codex 会话。 |
| cc_cleanup_sessionsA | 清理已经不存在的 Claude Code/Codex 可见会话登记。 |
| cc_session_statusC | 查看受管 CLI 当前状态,只读取最近输出:等待确认、报错、完成、运行中或空闲。 |
| cc_focus_sessionB | 把指定 Claude Code/Codex 可见会话窗口拉到前台。 |
| cc_send_instructionC | 向已启动的受管 CLI 会话发送自然语言任务说明。 |
| cc_send_decisionC | 当 CLI 等待确认时发送 yes/no/cancel;默认允许,可通过配置改成确认或禁止。 |
| cc_send_slash_commandB | 发送 /init、/compact、/model 等内部命令;默认允许,可通过配置收紧。 |
| cc_switch_modelC | 切换受管 Claude Code/Codex 会话模型;默认允许所有模型,可用配置收紧。 |
| cc_stop_sessionC | 停止受管 Claude Code/Codex CLI 会话,并关闭前台 Terminal 窗口。 |
| cc_close_terminalB | 当用户说“关闭终端/关闭cc窗口”时调用,关闭前台 Terminal/iTerm 窗口。 |
| desktop_rememberC | 语音友好入口:当用户说“记一下...”时保存到 Obsidian。 |
| desktop_open_cc_projectC | 语音友好入口:打开某个项目的 Claude Code/Codex 可见窗口。 |
| desktop_list_projectsA | 列出可以被桌面 MCP 打开的白名单项目。 |
| desktop_resolve_projectA | 把项目名、目录名或白名单路径解析为安全项目路径。 |
| desktop_open_cc_project_namedC | 按项目名/别名打开 Claude Code/Codex 可见窗口。 |
| desktop_ask_cc_projectC | 按项目名/别名把任务交给 Claude Code/Codex。 |
| desktop_ask_ccC | 语音友好入口:把一句自然语言任务交给 Claude Code/Codex。 |
| desktop_check_ccC | 语音友好入口:看看 Claude Code/Codex 当前在做什么或卡在哪。 |
| desktop_continue_ccC | 语音友好入口:让 Claude Code/Codex 继续。 |
| desktop_focus_ccB | 语音友好入口:把 Claude Code/Codex 窗口切到前台。 |
| desktop_stop_ccC | 语音友好入口:退出 Claude Code/Codex 并关闭窗口。 |
| xcode_open_projectB | 打开白名单项目内的 .xcodeproj 或 .xcworkspace。 |
| xcode_buildC | 在白名单项目内执行 xcodebuild build。 |
| xcode_testC | 在白名单项目内执行 xcodebuild test。 |
| xcode_cleanC | 在白名单项目内执行 xcodebuild clean。 |
| xcode_last_errorsC | 读取最近一次 xcodebuild 输出中的错误线索。 |
| desktop_health_detailA | 诊断桌面 MCP 环境:路径、CLI、终端 App、关键配置。 |
| desktop_config_summaryA | 返回脱敏配置摘要,方便排查桌面 MCP 环境。 |
| desktop_tool_catalogA | 返回桌面 MCP 工具目录,帮助小智/Java 选择高层工具。 |
| desktop_category_registryA | 返回通用桌面能力分类,例如 music、docs、ai、dev、browser、system。 |
| desktop_intentD | 通用桌面意图入口:按 category + intent 路由到底层安全能力。 |
| pending_action_createA | 创建一个待确认动作;只允许白名单动作类型,不会立即执行。 |
| pending_action_listB | 列出待确认动作;status 为空时列出全部。 |
| pending_action_confirmC | 确认并执行一个待确认动作。 |
| pending_action_cancelC | 取消一个待确认动作,不执行。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/jijiutong/xiaozhi-desktop-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server