The Glean MCP server exposes a family of tools that let the assistant query the user's company knowledge: documents, people, meetings, email, internal code, the user's activity feed, structured memory, and the knowledge graph. This skill is the entry point. It maps a user's question to the right tool, names the rules that apply across all of them, and links to per-tool reference files that carry the deep syntax.
Where these tools live
The tools listed below come from the user's Glean MCP server connection. Refer to them by their bare names (search, employee_search, meeting_lookup, …) — the assistant resolves them against the active tool inventory.
In the raw MCP tool list, Glean tools appear as mcp__glean_[server-name]__[tool] where [server-name] is the user's configured server identifier (e.g., default, production, acme). The tool suffix after the final __ is always consistent across deployments. Use whatever Glean server is visible in your tool inventory.
If no Glean tools are visible, ask the user to set up Glean by prompting the
harness (for example, Set up Glean for me).
Intent → tool decision tree
| The user is asking about... | Reach for | Reference |
|---|---|---|
| Documents, wikis, policies, RFCs, specs | search |
search.md |
| A complex question that needs synthesis across sources | chat |
chat.md |
| Internal source code, files, commits across repos | code_search |
code-search.md |
| People, teams, org structure, reporting lines | employee_search |
employee-search.md |
| Meetings, transcripts, decisions, action items | meeting_lookup |
meeting-lookup.md |
| Gmail messages, threads, attachments | gmail_search |
gmail-search.md |
| Outlook messages, threads, attachments | outlook_search |
outlook-search.md |
| Reading a specific URL / document | read_document |
read-document.md |
| The user's own recent activity (standup, weekly summary) | user_activity |
user-activity.md |
| The user's stored memories / personalization | memory (+ memory_schema) |
memory.md |
| Structured entity / relationship queries | knowledge_graph_query (+ knowledge_graph_schema) |
knowledge-graph.md |
The reference files are loaded only when needed. Open the relevant one before invoking a tool you haven't used recently — each file carries the exact param shape, the filter syntax, and the pitfalls that have bitten previous calls.
Cross-tool rules
These apply regardless of which Glean tool is active. Internalize them, don't re-derive per call.
- Never use
searchfor people lookups. It searches documents; it doesn't index people. Useemployee_search. - Cite every claim with a URL. Glean returns links; surface them so the user can verify. No URL → likely fabricated.
- Permission-empty results are valid signals. If a tool returns nothing, that often means the user lacks access — not that the information is missing. Don't pad with weak alternatives; report empty cleanly.
- Prefer recent over old. Glean returns by relevance; for currency-sensitive questions, add a date filter or sort by recency rather than presenting stale top hits as authoritative.
- Vet before presenting. Apply the criteria in reference/vetting.md — relevance, freshness, authority. Better to return three vetted results than ten unfiltered ones.
Cross-cutting reference
- synthesis.md — patterns for combining multiple Glean tools when a single tool doesn't answer the question.
- vetting.md — how to evaluate source quality, freshness, and authority; when to communicate confidence to the user.
Glean platform agents
If the user's Glean instance has platform agents enabled, those agents may surface as additional MCP tools alongside the built-in tools above. The set is org-specific and can change at any time. See agents-as-tools.md for how to recognize, introspect, and invoke them.