Matterport
Capture, share, and collaborate the built world in immersive 3D
Verdict
Common use cases
- Archive old property scans after closing
- Pull room classifications for floor plan reports
- Set up webhooks for new scan notifications
- Search models by address or capture date
- Retrieve embed codes for client presentations
Integration
- Vendor
- Matterport
- Category
- developer-tools
- Auth
- OAUTH2
- Tools
- 6
- Composio slug
matterport
Tools
- Delete Matterport Modeldestructive
Tool to permanently delete a Matterport model. Use when you need to remove a model entirely from the Matterport platform. This operation is irreversible.
- Get Model by ID
Tool to retrieve detailed information about a single Matterport 3D model by its ID. Use when you need to fetch model metadata, publication details, spatial information, or other properties of a specific Matterport model.
- Get Model Event Webhook Callbacks
Tool to retrieve a list of registered webhook callback configurations for model events. Use when you need to view all configured webhooks that receive notifications when model events occur (e.g., created, deleted, updated, processed, transf
- List Room Classifications
Tool to list all room classifications defined for Matterport room classification models. Use when you need to retrieve the available room types and their associated keywords.
- Query Matterport Models
Tool to retrieve a page of Matterport models with optional search and filtering. Use when you need to list, search, or filter models within an organization.
- Update Model State
Tool to change a Matterport model between active and inactive (archived) states. Use when you need to archive an inactive model or unarchive an active model. This operation is idempotent.
Setup
Setup guide
- 11. Open any Space in Switchy and click the MCP icon in the sidebar. 2. Search for Matterport and click Connect. 3. You'll be redirected to Matterport's OAuth consent screen — sign in with an account that has admin access to your organization. 4. Grant the requested scopes (read models, write models, manage webhooks). 5. Switchy redirects you back and confirms the connection. 6. Return to your Space and type '@Matterport list the five most recent models' to test — you should see a table of scan names, IDs, and creation dates. 7. If the response is empty, verify your Matterport account actually owns models and that the OAuth token includes your organization ID. 8. To invoke other tools, @mention Matterport and describe the task in plain language — the AI will map your request to the appropriate tool.
What teammates see: by default, memories from Matterport are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
List Recent Scans
@Matterport show me the ten most recent models, including their names, IDs, and whether they're published.Open in a Space →
Get Model Details
@Matterport retrieve all details for model ID abc123xyz, especially the floor area and number of rooms.Open in a Space →
Archive Inactive Model
@Matterport archive model ID def456uvw because the property sold and we no longer need the scan active.Open in a Space →
Check Webhook Config
@Matterport list all webhook callbacks configured for model events and show me their target URLs.Open in a Space →
Find Models by Keyword
@Matterport search for models with '123 Main Street' in the name or description and return the top five results.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Matterport show me all models tagged 'retail' that were created in the last 30 days, sorted by capture date
Found 7 Matterport models matching your criteria: 1. Downtown Flagship Store (sid: m_abc123) — captured Dec 15, 2024, published, 3,450 sq ft 2. Mall Kiosk Prototype (sid: m_def456) — captured Dec 12, 2024, unpublished, 850 sq ft 3. Warehouse Showroom (sid: m_ghi789) — captured Dec 8, 2024, published, 12,200 sq ft (4 more entries truncated for brevity) Each entry includes the model's publication status, spatial dimensions, and direct link to the Matterport Cloud dashboard. This is an illustrative example; actual results depend on your organization's model library.
This example demonstrates the Query Matterport Models tool with search filters. Requires OAuth2 scope for read access to models. The MCP returns paginated results (default 10 per page), so large model libraries may need follow-up prompts to retrieve subsequent pages. Useful for auditing recent captures or filtering by custom tags.
@Matterport archive the model m_old789 and confirm it's no longer active in our production catalog
Model m_old789 ("Legacy Office Layout") has been successfully archived. State changed from active to inactive. This model is now hidden from public-facing galleries and search results, but remains accessible via direct link for internal reference. The archive operation is idempotent — running it again will have no effect. To restore this model, use the Update Model State tool with state: active. This is an illustrative example of the expected workflow.
This example showcases the Update Model State tool, which archives or unarchives models without deleting them. Requires OAuth2 write scope. Archiving is reversible, unlike deletion. Use this when rotating out seasonal spaces or deprecating old captures while preserving historical data. The MCP confirms the state transition in its response.
@Matterport pull the full metadata for model m_xyz456 and summarize what room types were detected during the scan
Model m_xyz456 ("Corporate HQ — Floor 3") metadata retrieved: **Detected room classifications:** Conference Room (2), Open Office (1), Kitchen/Break Room (1), Restroom (2), Storage Closet (1). **Spatial summary:** Total area 8,750 sq ft, captured Nov 22, 2024, published Dec 1, 2024. The model includes 47 scan positions and is tagged with 'headquarters', 'office-space'. Room classifications are based on Matterport's ML model and may require manual review for accuracy. This is an illustrative synthesis of the Get Model by ID response.
This example pairs the Get Model by ID tool with AI reasoning to extract and summarize room classification data. Requires OAuth2 read scope. Room classifications are auto-generated by Matterport's CV pipeline and may not be 100% accurate — verify critical classifications manually. Useful for space planning, lease documentation, or facility audits.
Use-case deep-dives
When this MCP wins for property marketing teams
A 3-person real estate marketing team publishes 40-60 property listings monthly, each with a Matterport tour embedded in the MLS feed. They need to archive tours after close and pull metadata for social posts. This MCP is the right call if your team already uses Matterport as the single source of truth for 3D tours. The query and update tools let you script the archive workflow and pull model URLs for automated posting. The OAuth2 flow means each agent can act on behalf of the authenticated user without sharing API keys. The threshold: if you're managing tours across multiple platforms (Zillow 3D, Realtor.com tours), this MCP won't unify them—it's Matterport-only. For teams running 30+ tours a month in Matterport alone, the automation pays off in week two.
When webhook callbacks matter for site tracking
A 6-person construction tech startup builds a dashboard that shows clients weekly progress scans of job sites. Field techs capture Matterport scans on Fridays; the dashboard auto-updates Monday morning. This MCP is borderline unless you're already using Matterport's webhook system. The get-webhook-callbacks tool lets you audit which events trigger your pipeline, but it doesn't create or update webhooks—that's outside the MCP scope. If your workflow is "scan uploaded, dashboard refreshes," you need the webhook config done separately, then use this MCP to verify it's live. The room-classification tool is a bonus for tagging spaces ("framing complete in kitchen"), but it's not the hero feature. For teams with fewer than 10 sites, manual refresh is faster than debugging webhook plumbing.
When model metadata drives maintenance schedules
A 12-person facilities team manages 200+ commercial buildings, each with a Matterport scan updated quarterly. They pull spatial data and room classifications to schedule HVAC inspections and floor refinishing. This MCP is the right call if you're treating Matterport models as a structured data source, not just visual walkthroughs. The get-model-by-id and list-room-classifications tools let you script reports that map "conference rooms over 500 sq ft" to "quarterly deep-clean." The delete and update-state tools handle the archive cycle when buildings are sold or demolished. The trade-off: if your building data lives in a CMMS (like Maximo or ServiceNow), this MCP won't sync it—you're pulling Matterport metadata into your own system. For teams managing 50+ scans with structured maintenance rules, the scripting time breaks even in month one.
Frequently asked
What does the Matterport MCP let me do in Switchy?
It connects your Matterport 3D models to Switchy's AI workspace. You can query models by name or filter, fetch metadata like publication status and spatial data, archive or unarchive models, and delete models permanently. The MCP also lets you list room classifications and manage webhook callbacks for model events. Useful if your team works with 3D scans and wants AI to search or update models without opening Matterport's dashboard.
Do I need admin access to connect Matterport via OAuth?
You need a Matterport account with API access enabled. OAuth scopes depend on what your team wants to do—read-only access for querying models, write access for archiving or deleting. Matterport's OAuth flow will prompt you to grant those permissions. If you're on a team plan, check with your Matterport admin whether API access is available and which scopes your role allows.
Can the MCP edit 3D models or change room labels?
No. It can't edit the 3D geometry, textures, or room labels inside a model. The MCP handles metadata operations—archiving, deleting, fetching publication details, listing room classifications. If you need to change the actual scan data or room tags, you still do that in Matterport's native editor. This MCP is for managing the model library, not the model content.
Why use this MCP instead of Matterport's API directly?
The MCP wraps Matterport's API so Switchy's AI can call it in natural language. Instead of writing code to filter models or check webhook configs, you ask the AI "show me all archived models" or "delete model X". It's faster for ad-hoc queries and one-off tasks. If you're building a custom integration or need sub-second latency, use Matterport's API directly.
Who on the team should connect the Matterport MCP?
Whoever owns your Matterport organization or has API credentials. That person connects once via OAuth; then anyone in your Switchy workspace can use the MCP to query or manage models. If multiple people need delete permissions, make sure the connecting account has those scopes. The MCP doesn't count against Matterport's scan or storage limits—it just reads and writes metadata.