search_messages

MCP tool from MCP Agent Mail by Dicklesworthstone

searchmessages(projectkey: str, query: str, limit?: int, agentname?: str, registrationtoken?: str)

How to use it

Project documentation lists search_messages for the MCP Agent Mail MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), then check which tools your installed version makes available. Tool availability can depend on configuration and credentials. A server handshake does not verify this tool’s behavior. See the full listing for setup details.

FULL MCP AGENT MAIL LISTING

Other tools in MCP Agent Mail (26)

acknowledge_message

acknowledgemessage(projectkey: str, agentname: str, messageid: int, registrationtoken?: str)

create_agent_identity

createagentidentity(projectkey: str, program: str, model: str, namehint?: str, taskdescription?: str, attachmentspolicy?: str)

ensure_project

ensureproject(humankey: str)

fetch_inbox

fetchinbox(projectkey: str, agentname: str, limit?: int, urgentonly?: bool, includebodies?: bool, sincets?: str, topic?: str, unreadonly?: bool, registrationtoken?: str)

file_reservation_paths

filereservationpaths(projectkey: str, agentname: str, paths: list[str], ttlseconds?: int, exclusive?: bool, reason?: str, registrationtoken?: str)

force_release_file_reservation

forcereleasefilereservation(projectkey: str, agentname: str, filereservationid: int, notifyprevious?: bool, note?: str, registrationtoken?: str)

health_check

healthcheck()

install_precommit_guard

installprecommitguard(projectkey: str, coderepopath: str)

list_contacts

listcontacts(projectkey: str, agentname: str, registrationtoken?: str)

macro_contact_handshake

macrocontacthandshake(projectkey: str, requester

macro_file_reservation_cycle

macrofilereservationcycle(projectkey: str, agentname: str, paths: list[str], ttlseconds?: int, exclusive?: bool, reason?: str, autorelease?: bool, registrationtoken?: str)

macro_prepare_thread

macropreparethread(projectkey: str, threadid: str, program: str, model: str, agentname?: str, registrationtoken?: str, taskdescription?: str, registerifmissing?: bool, includeexamples?: bool, inboxlimit?: int, includeinboxbodies?: bool, llmmode?: bool, llmmodel?: str)

macro_start_session

macrostartsession(humankey: str, program: str, model: str, taskdescription?: str, agentname?: str, registrationtoken?: str, filereservationpaths?: list[str], filereservationreason?: str, filereservationttlseconds?: int, inboxlimit?: int)

mark_message_read

markmessageread(projectkey: str, agentname: str, messageid: int, registrationtoken?: str)

register_agent

registeragent(projectkey: str, program: str, model: str, name?: str, taskdescription?: str, attachmentspolicy?: str)

release_file_reservations

releasefilereservations(projectkey: str, agentname: str, paths?: list[str], filereservationids?: list[int], registrationtoken?: str)

renew_file_reservations

renewfilereservations(projectkey: str, agentname: str, extendseconds?: int, paths?: list[str], filereservationids?: list[int], registrationtoken?: str)

reply_message

replymessage(projectkey: str, messageid: int, sendername: str, bodymd: str, to?: list[str], cc?: list[str], bcc?: list[str], subjectprefix?: str, sendertoken?: str)

request_contact

requestcontact(projectkey: str, fromagent: str, toagent: str, toproject?: str, reason?: str, ttlseconds?: int, registrationtoken?: str)

respond_contact

respondcontact(projectkey: str, toagent: str, fromagent: str, accept: bool, fromproject?: str, ttlseconds?: int, registrationtoken?: str)

send_message

sendmessage(projectkey: str, sendername: str, to: list[str], subject: str, bodymd: str, cc?: list[str], bcc?: list[str], attachmentpaths?: list[str], convertimages?: bool, importance?: str, ackrequired?: bool, threadid?: str, autocontactifblocked?: bool, sendertoken?: str)

set_contact_policy

setcontactpolicy(projectkey: str, agentname: str, policy: str, registrationtoken?: str)

summarize_thread

summarizethread(projectkey: str, threadid: str, includeexamples?: bool, llmmode?: bool, llmmodel?: str, perthreadlimit?: int, agentname?: str, registrationtoken?: str)

sweep_stale_agents

sweepstaleagents(projectkey: str, agentname: str, thresholdseconds?: int, requirenoactivereservations?: bool, registrationtoken?: str)

uninstall_precommit_guard

uninstallprecommitguard(coderepopath: str)

whois

whois(projectkey: str, agentname: str, includerecentcommits?: bool, commitlimit?: int)