---
title: "Contacts"
url: "https://www.sensomcp.com/en/doc/tools/contact-tools"
lang: "en-GB"
description: "Senso MCP Contacts plugin tools: list, create, edit, publish and delete Joomla contacts and their categories from a conversation."
category: "Tool Reference"
author: "Fred Oliver"
published: "2026-11-19T19:28:09+00:00"
modified: "2026-11-19T19:28:09+00:00"
---

# Contacts

- Abstract: This page lists the tools in the Senso MCP Contacts plugin for listing, creating, editing, publishing and deleting contacts from Joomla's Contacts component, managing their categories, custom fields and contact form. Each tool specifies the required permission for com\_contact.

Manage contact records, their categories and their forms.

Intermediate

- contacts, Contacts
- categories, Categories
- bon-a-savoir, Good to know
- exemples-de-prompts, Prompt examples

Free

The Contacts plugin manages Joomla's Contacts component records and their categories through a simple conversation with your AI assistant.

These tools work with the **Contacts** component (`com_contact`). They are only made available to the assistant if this component is enabled on the site. It is often disabled by default, so enable it under System → Manage → Extensions if necessary. Every action requires access to the Contact Manager (`core.manage`), as in the administration interface, in addition to the permission indicated in the “Required permissions” column. Contacts do not have their own permissions, so permissions are checked on their category.

## Contacts

View and maintain contact records: position, email, phone numbers, address, website, free-form text, image and linked user account.

| Tool | Function | Required permissions (ACL) |
|---|---|---|
| `list_contacts` | List and search contacts, with filters for category, status, featured status, language and linked account | Admin access — `core.manage` |
| `get_contact` | Read a complete record, including its custom fields, tags and public link | Admin access — `core.manage` |
| `create_contact` | Create a contact | Admin access + Create in the category — `core.manage` + `core.create` |
| `update_contact` | Edit a contact (only the fields provided are changed) | Admin access + Edit — `core.manage` + `core.edit` (or `core.edit.own` for its author) |
| `set_contact_state` | Publish, unpublish, archive, move to the trash or feature a contact | Admin access + Edit State — `core.manage` + `core.edit.state` |
| `delete_contacts` | Permanently delete contacts that have been moved to the trash | Admin access + Delete — `core.manage` + `core.delete` |

Custom field values (context `com_contact.contact`) are passed through the `fields` argument, using the field name. The contact form is enabled with `contact_form`, and the page displayed after submission is configured with `redirect`; other display options (`params`) are merged with the existing settings without overwriting them.

## Categories

Organize contacts by category (team, department, agency...).

| Tool | Function | Required permissions (ACL) |
|---|---|---|
| `list_contact_categories` | List contact categories, with the number of contacts | Admin access — `core.manage` |
| `create_contact_category` | Create a contact category | Admin access + Create — `core.manage` + `core.create` |

## Good to know

- A nonexistent category is rejected: the assistant never creates a category by mistake. If no category is specified, the component's only published category is used when there is just one.
- Permanent deletion takes place in two steps: a preview first, followed by execution after you approve it. Only contacts in the trash can be deleted, as in the administration interface.
- Creations, edits, status changes and deletions appear in Joomla's action log.
- Sending a message through the contact form is not available to the assistant.

## Prompt examples

> “Add our two new sales representatives to the Contacts page, including their phone numbers and email addresses.”
>
> “Enable the contact form on the customer service record and redirect to the Thank You page after submission.”
