Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_emailsA

Search the local mail index with a mu query.

Returns one line per message: date | from | subject | path. Pass the path to view_emails or list_attachments.

Query syntax (quote phrases with double quotes; no shell is involved):

  • Bare words search from/to/cc/subject/body: invoice march

  • Fields: from: to: cc: contact: (any address) subject: body: maildir: (e.g. maildir:/Inbox) list: tag: file: (attachment name) mime: (attachment type, e.g. mime:application/pdf, mime:image/*)

  • Dates: date:2024-04..2024-04, date:2w.. (last 2 weeks), date:..2023, date:today.. (units: h d w m y)

  • Flags: flag:attach flag:unread flag:flagged flag:replied flag:personal flag:list flag:calendar

  • Operators: and, or, not, parentheses; implicit and between terms.

  • Wildcard suffix: budg*. Regex: subject:/re.?port/

  • Names match words in the address too: from:alice, from:amazon

Examples:

  • from:alice date:1w..

  • subject:"meeting notes"

  • mime:application/pdf and date:2025-04..2025-04

  • (from:bank or from:visa) and flag:unread

  • contact:bob and not flag:list

Args: query: the mu query. max_results: cap on returned messages; raise it or narrow the query if the result is cut off. sort: field to sort by. newest_first: reverse sort order (newest/Z first). include_thread: also return other messages from matching threads.

view_emailsA

Read emails (headers + body as text) given paths from search_emails.

HTML-only emails are converted to plain text.

Args: paths: message file paths. max_chars: per-message cap on returned text.

list_attachmentsC

List the MIME parts (attachments, inline images, bodies) of one email.

open_attachmentA

Save attachments of an email to a temp dir, optionally opening them.

Returns the saved file paths, so their contents can be read afterwards.

Args: path: message file path. pattern: case-sensitive PCRE matched against attachment file names, e.g. .*\.pdf$ or (?i)invoice. Default: all attachments. open_in_viewer: also open each file with the OS default application.

mu_helpA

Full mu reference, for when the short guide in search_emails isn't enough.

Topics: query (complete query language), fields (live list of fields and flags), find (search options), extract (attachment handling).

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.7/5.0

Scored across 5 tools

Disambiguation5/5

Each tool targets a distinct action: search metadata, view message bodies, list MIME parts, save/open attachments, and read help. Boundaries are clear; no two tools overlap in purpose.

Naming Consistency4/5

Four tools follow a consistent verb_noun snake_case pattern (search_emails, view_emails, list_attachments, open_attachment), but mu_help deviates and list_attachments/open_attachment mix plural/singular. Minor deviations only.

Tool Count5/5

Five tools are well-scoped for a local email search/read server. Each tool earns its place; no bloat or missing essential primitive.

Completeness3/5

Search and view cover the core read path, but open_attachment saves files without any tool to read their contents afterward, creating a dead end for attachment processing. No update/tag operations either, though those may be outside the read-only scope.

Maintenance

ActivityMaintained
ResponsivenessNo issues