Official item MCP

Use the item MCP server to give AI clients access to your item workspace through the Model Context Protocol.

Server URL

Use this URL in MCP clients that support remote HTTP or Streamable HTTP servers:

https://mcp.item.app/mcp

If a client asks for a transport, choose HTTP, Streamable HTTP, or Remote HTTP. Do not choose a local command or stdio server.

Authentication

The item MCP server uses OAuth. When you connect, your MCP client opens an item authorization page in your browser. Sign in with the item account you want the client to use, review the requested access, and allow access. Your Item account must also have active app access under the same billing rules as the web app. The MCP endpoint is protected, so opening https://mcp.item.app/mcp directly in a browser may show a missing authorization error. That is expected. Connect through one of the MCP clients below instead.

Available tools

The item MCP server exposes one read-only natural-language assistant plus a curated set of structured tools for object lookup, schema inspection, and internal Item updates. Tool availability depends on your account permissions and connected integrations. External messaging tools, calendar write tools, Slack and LinkedIn sending tools, enrichment tools that may spend credits, raw SQL, bulk mutation tools, and skill triggering tools are not exposed as direct MCP tools.

Assistant

Tool	Description
`ask_item_assistant`	Ask the Item assistant a natural-language question in read-only mode. Prefer this for complex requests that require analysis, multi-step reasoning, synthesis across object types, emails, meetings, meeting recordings, timelines, or many CRM objects. Pass the returned `thread_id` on follow-up calls to continue the same conversation.

Objects and schema

Tool	Description
`search_objects`	Structured read-only search over Item CRM objects by query, object type, field, relationship, limit, and offset.
`get_object`	Fetch one Item CRM object by `object_slug` and `object_id`.
`list_object_types`	List active system and custom object types available to the organization. Use this before searching when you need valid object type slugs.
`get_object_schema`	Get field definitions for one object type by slug. Use this before building field-aware UI or performing field updates.
`create_object`	Create a new CRM object. `objectSlug` is required, along with the field values for the object.
`update_object`	Update fields on an existing CRM object. `objectSlug` and `id` are required.
`delete_object`	Delete an existing CRM object. `objectSlug` and `id` are required.

Views

Tool	Description
`list_views`	List saved views for an object type, including saved filters, columns, sorting, and view type.
`execute_view`	Execute a saved view to return filtered, sorted, paginated records. Use `list_views` first to find the `view_id`.

Lists

Tool	Description
`list_lists`	Browse available lists in the organization, optionally filtering by name or object type.
`get_list`	Get list details and member records. Use `list_lists` first to find the list ID.
`create_list`	Create a new list for an object type.
`add_to_list`	Add a contact, company, or custom object to a list.
`remove_from_list`	Remove a single object from a list.

Notes and tasks

Tool	Description
`create_note`	Create a new note on a CRM record.
`edit_note`	Edit an existing note.
`search_notes`	Search notes attached to CRM records.
`search_tasks`	Search tasks by status, scheduled, created, or completed dates, assignee, associated objects, and optional free-text query. Use this to resolve a task ID before updating or deleting a task.
`create_task`	Create an immediate, scheduled, reactive, recurring, or blocked task for the AI or a user.
`update_task`	Update a task by completing it, cancelling it, reassigning it, rescheduling it, adding notes, linking objects, or resuming a blocked AI task with new context.
`delete_task`	Delete a task after confirmation. This action cannot be undone from the assistant UI.

ChatGPT

ChatGPT supports remote MCP servers through Developer mode.

Open ChatGPT settings.
Go to Apps.
Open Advanced settings and enable Developer mode.
In Apps settings, choose Create app.
Use item as the app name.
Use https://mcp.item.app/mcp as the remote MCP server URL.
Complete the item OAuth flow when ChatGPT opens the authorization page.
In a chat, open the tools or plus menu, choose Developer mode, and enable item for the conversation.

Some ChatGPT workspaces still show this under Connectors instead of Apps. In that UI, enable Developer mode under Settings > Connectors > Advanced, then add a custom remote MCP connector with the same server URL.

Claude

Claude supports custom connectors backed by remote MCP servers. For Pro or Max plans:

Open Claude.
Go to Customize > Connectors.
Click + and choose Add custom connector.
Enter item as the connector name.
Enter https://mcp.item.app/mcp as the remote MCP server URL.
Leave advanced OAuth client fields blank unless your workspace admin gave you specific values.
Finish adding the connector, then click Connect and complete the item OAuth flow.
In a conversation, open the connector menu and enable item.

For Team and Enterprise plans, an organization Owner may need to add the connector first from Organization settings > Connectors. After that, each user connects their own item account from Customize > Connectors.

Claude Code

Add item as a remote HTTP MCP server:

claude mcp add --transport http item https://mcp.item.app/mcp

Then start Claude Code in the project where you want to use item and run:

/mcp

Select item, follow the browser OAuth flow, and return to Claude Code. You can verify the server with:

claude mcp list

To make item available in every Claude Code project on your machine, add it with user scope:

claude mcp add --transport http --scope user item https://mcp.item.app/mcp

Codex

Add item with the Codex CLI:

codex mcp add item --url https://mcp.item.app/mcp

Codex will detect OAuth support and open the item authorization flow. After you allow access, verify the server is configured:

codex mcp list

The Codex CLI and Codex IDE extension share MCP configuration, so adding the server once makes it available in both.

Cursor

Cursor reads MCP server configuration from mcp.json. For a global setup, create or edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "item": {
      "url": "https://mcp.item.app/mcp"
    }
  }
}

For a project-only setup, create or edit .cursor/mcp.json in your project with the same JSON. Restart Cursor after saving the file. Then open Settings > Tools & Integrations or Settings > MCP, find item, and connect. Cursor should open the item OAuth flow the first time it needs to authenticate.

Misc clients

Use item with any MCP client that supports remote HTTP MCP servers and OAuth. When configuring the client:

Set the server name to item.
Set the server URL to https://mcp.item.app/mcp.
Choose HTTP, Streamable HTTP, or Remote HTTP if the client asks for a transport.
Complete the browser OAuth flow when prompted.

Clients that only support local stdio MCP servers cannot connect directly to the hosted item MCP server. Those clients need a remote MCP bridge or proxy that can speak HTTP to item.

Troubleshooting

If the client does not open a browser, copy the authorization URL it prints and open it manually. If you connected with the wrong item account, remove or disconnect the MCP server in the client, then add it again and sign in with the correct account. If a client says the server is unauthorized before you have completed OAuth, retry the connection from the client UI or command. The first unauthenticated request is how MCP clients discover item’s OAuth configuration.

​Server URL

​Authentication

​Available tools

​Assistant

​Objects and schema

​Views

​Lists

​Notes and tasks

​ChatGPT

​Claude

​Claude Code

​Codex

​Cursor

​Misc clients

​Troubleshooting