list_objects
List Objects
List records for a specific item object type such as contacts, companies, or a custom object. Supports pagination, search, sorting, and field-based filters.
Ask your agent in plain language. Each of these maps to a real tool on the server.
item is a CRM for people, companies and custom objects. The integration lets an agent read shared views, check the schema, upsert records in batches and trigger item skills through webhooks.
Read a company and its related people before a call, from the views your team already uses.
Batch upsert people or companies with new details gathered by the agent.
Read the schema first so custom object fields are written with the right names and types.
Trigger a webhook-based skill in item when a deal or record changes.
item connects with an API key from your item workspace. The key carries the access of the workspace it belongs to, so store it in Metorial rather than in local client config.
Sign-in options on Metorial: API Key.
list_objects
List records for a specific item object type such as contacts, companies, or a custom object. Supports pagination, search, sorting, and field-based filters.
create_object
Create a new contact, company, or custom object record in item. Contacts and companies may deduplicate automatically based on item matching rules.
delete_object
Soft-delete an item record by ID. Relationships involving the record are also soft-deleted.
update_object
Update one or more fields on an existing item record. Supports both system fields and custom fields, leaving unspecified fields unchanged.
get_object
Fetch a single item record by ID, or by email for contacts. Useful for retrieving the full flattened record with all available fields.
list_users
List organization users in item, including their IDs and access levels. Useful for mapping owner fields or assigning records.
execute_view
Run a shared item view and return its filtered, sorted records. This is the preferred way to pull structured item data on a schedule.
get_schema
Retrieve the item schema for all available object types, including field definitions, select options, and percentage precision/value scale. Useful for discovering custom objects and valid field names before creating or updating records.
batch_upsert_objects
Create or update up to 100 item records in one request. Each record is processed independently, so partial success is possible.
list_views
List shared views configured for an item object type. Views capture saved filters, sorting, and visible columns from the item UI.
trigger_skill_webhook
Send a JSON payload to an item skill webhook to start a skill run. Optionally signs the payload with an HMAC-SHA256 signature using the API key as the shared secret.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Manage people, companies, and custom objects in item. Query shared views, inspect schema, batch upsert records, list users, and trigger webhook-based skills.
Common questions about connecting Item to AI agents with Metorial.