Agent Mail MCP Server

"It's like gmail for your coding agents!"

Local server

What is the Agent Mail MCP Server?

Agent Mail is an MCP project maintained in the dicklesworthstone/mcp_agent_mail repository. The maintainer describes its purpose as “"It's like gmail for your coding agents!"”. Read the project documentation for the complete scope.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
health_checkhealth_check()
ensure_projectensure_project(human_key: str)
register_agentregister_agent(project_key: str, program: str, model: str, name?: str, task_description?: str, attachments_policy?: str)
whoiswhois(project_key: str, agent_name: str, include_recent_commits?: bool, commit_limit?: int)
create_agent_identitycreate_agent_identity(project_key: str, program: str, model: str, name_hint?: str, task_description?: str, attachments_policy?: str)
sweep_stale_agentssweep_stale_agents(project_key: str, agent_name: str, threshold_seconds?: int, require_no_active_reservations?: bool, registration_token?: str)
send_messagesend_message(project_key: str, sender_name: str, to: list[str], subject: str, body_md: str, cc?: list[str], bcc?: list[str], attachment_paths?: list[str]…
reply_messagereply_message(project_key: str, message_id: int, sender_name: str, body_md: str, to?: list[str], cc?: list[str], bcc?: list[str], subject_prefix?: str…
request_contactrequest_contact(project_key: str, from_agent: str, to_agent: str, to_project?: str, reason?: str, ttl_seconds?: int, registration_token?: str)
respond_contactrespond_contact(project_key: str, to_agent: str, from_agent: str, accept: bool, from_project?: str, ttl_seconds?: int, registration_token?: str)
list_contactslist_contacts(project_key: str, agent_name: str, registration_token?: str)
set_contact_policyset_contact_policy(project_key: str, agent_name: str, policy: str, registration_token?: str)
fetch_inboxfetch_inbox(project_key: str, agent_name: str, limit?: int, urgent_only?: bool, include_bodies?: bool, since_ts?: str, topic?: str, unread_only?: bool…
mark_message_readmark_message_read(project_key: str, agent_name: str, message_id: int, registration_token?: str)
acknowledge_messageacknowledge_message(project_key: str, agent_name: str, message_id: int, registration_token?: str)
macro_start_sessionmacro_start_session(human_key: str, program: str, model: str, task_description?: str, agent_name?: str, registration_token?: str, file_reservation_paths?…
macro_prepare_threadmacro_prepare_thread(project_key: str, thread_id: str, program: str, model: str, agent_name?: str, registration_token?: str, task_description?: str…
macro_file_reservation_cyclemacro_file_reservation_cycle(project_key: str, agent_name: str, paths: list[str], ttl_seconds?: int, exclusive?: bool, reason?: str, auto_release?: bool…
macro_contact_handshakemacro_contact_handshake(project_key: str, requester
search_messagessearch_messages(project_key: str, query: str, limit?: int, agent_name?: str, registration_token?: str)
summarize_threadsummarize_thread(project_key: str, thread_id: str, include_examples?: bool, llm_mode?: bool, llm_model?: str, per_thread_limit?: int, agent_name?: str…
install_precommit_guardinstall_precommit_guard(project_key: str, code_repo_path: str)
uninstall_precommit_guarduninstall_precommit_guard(code_repo_path: str)
file_reservation_pathsfile_reservation_paths(project_key: str, agent_name: str, paths: list[str], ttl_seconds?: int, exclusive?: bool, reason?: str, registration_token?: str)
release_file_reservationsrelease_file_reservations(project_key: str, agent_name: str, paths?: list[str], file_reservation_ids?: list[int], registration_token?: str)
force_release_file_reservationforce_release_file_reservation(project_key: str, agent_name: str, file_reservation_id: int, notify_previous?: bool, note?: str, registration_token?: str)
renew_file_reservationsrenew_file_reservations(project_key: str, agent_name: str, extend_seconds?: int, paths?: list[str], file_reservation_ids?: list[int], registration_token?: str)