droid-mcp-contacts/io.droidmcp.contacts/ContactsTools

ContactsTools

Provider for the contacts tool module. Wires up SearchContactsTool, ReadContactTool, ListContactsTool, CreateContactTool, UpdateContactTool and DeleteContactTool, which query and edit via ContactsContract.

The read tools need only READ_CONTACTS, so that is all requiredPermissions reports — a host with read-only contacts access still gets the read surface. The write tools are gated inside all: they are registered only when WRITE_CONTACTS is also granted (mirroring how CalendarTools gates its write tools).

Functions

all

fun all(context: Context): List<McpTool>

Contacts McpTools for the current grant state: read tools always, the write tools only with WRITE_CONTACTS.

hasPermissions

fun hasPermissions(context: Context): Boolean

True if all requiredPermissions are currently granted.

requiredPermissions

fun requiredPermissions(): List<String>

Permissions needed to register this module at all: READ_CONTACTS (write access is gated per tool in all).

resources

fun resources(context: Context): ResourceProvider

Contacts by id as MCP resources; register with DroidMcp.Builder.addResourceProvider.