Skip to main content
Glama
neil-zielsdorf

tbird-mcp

by neil-zielsdorf
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
TBIRD_PROFILENoAbsolute path to a specific Thunderbird profile dir (default: the active profile from profiles.ini).
TBIRD_CREDENTIALSNoPath to the credentials file (default: ~/.config/tbird-mcp/credentials.toml).

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
list_accountsA

List incoming mail accounts discovered from Thunderbird (with their on-disk store).

list_foldersC

List mbox folder names for an account (by email address).

search_mailA

Search a folder's mbox.

Filters are ANDed and case-insensitive substring matches. since/before take ISO dates (YYYY-MM-DD). Without account, searches every account's folder. Returns summaries with an opaque id for read/extract. Note: searching a very large folder streams the whole file and can take a few seconds; narrow with account and a tight limit when possible.

read_messageA

Read one message by its id (from search_mail): headers + decoded body.

list_attachmentsC

List attachment filenames on a message.

extract_attachmentsB

Save a message's attachments to dest_dir; returns the written file paths.

list_identitiesA

List send-from identities and whether each can send right now.

send_mailA

Send mail from one of your identities (SMTP), then file a copy in Sent.

from_address must be a configured identity (see list_identities). Multiple recipients may be comma-separated. Hotmail/Outlook send is not available in v1 and returns a clear error.

SAFETY: dry_run defaults to True — it returns a preview without sending. Pass dry_run=False to actually send.

reload_configA

Re-read Thunderbird prefs.js and credentials.toml (after editing either).

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.7/5.0

Scored across 9 tools

Disambiguation5/5

Each tool targets a distinct action: listing accounts, listing folders, searching, reading, attachments, identities, sending, and reloading config. There is no overlap in functionality.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern in snake_case (e.g., list_accounts, search_mail, send_mail), making it easy to predict tool names.

Tool Count5/5

9 tools is well-scoped for a Thunderbird mail MCP, covering essential operations without being overwhelming or too sparse.

Completeness4/5

The set covers key mail operations (account listing, search, read, send, attachments) but is missing operations like create/delete folders or mark as read, which are minor gaps for the intended use.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources