WHER REMOTE CONNECTOR MCP

Ask your inventory from anywhere.

WHER keeps the record of what you own and where it was last put away. The MCP connector lets supported AI clients search that record, show saved photos and directions, and—if you grant write access—help update it.

Set up WHER MCP Try these prompts

Browser-based OAuth
Scope-by-scope control
Deletion is not exposed

WHER connected inventory:read

Where’d we put the black gear bag?

wher_find_item wher_get_guidance_target

It’s in Storage Bin 007 on the gear shelf in the garage.

Black gear bagGo to Garage, Gear shelf, Storage Bin 007. Open in WHER ↗

Connect from

Claude Claude Code Cursor ChatGPT Any MCP client

Put WHER to work

Useful questions, answered from your WHER records.

These are practical inventory jobs backed by tools WHER already provides. Ask naturally; the client handles the tool calls.

Find & guideRead · 0 Credits

Walk straight to the right bin

“Where’d we put the black gear bag? Can you show me what it looks like?”

Get the recorded location path, storage serial number, available guidance target, photo, and a direct Open in WHER link.

wher_find_itemwher_get_guidance_target

See insideRead · 0 Credits

Open a container without opening it

“What’s in Bin 007?”

Review the saved contents of a bin, drawer, shelf, box, cabinet, or other WHER container.

wher_list_container_contents

Location searchRead · 0 Credits

See everything in one place

“What camping gear is in the garage?”

Search across WHER locations, areas, zones, and containers with one natural-language request.

wher_search_by_location

Put awayWrite · 10 Credits

Add an item where it belongs

“I just bought a 10mm socket set. Put it in Drawer 2 of the tool chest.”

With write access and your approval, create the item in an existing WHER container. Repeating the same request does not duplicate it.

wher_create_item

MoveWrite · 10 Credits

Keep the last recorded place current

“I moved the camping stove to the shelf in the garage.”

Update its container and append movement history. WHER still has no MCP delete tool.

wher_update_item_location

QR labelsScoped access

Understand or assign a label

“What’s this label for?”

Resolve a registered label without changing it, or explicitly approve an unclaimed label assignment.

wher_resolve_qr_labelwher_assign_label

Last seenWrite · 10 Credits

Record where you just saw it

“I found the camping stove on the garage shelf. Make a note of that.”

Add a timestamped sighting from a person, camera, wearable, robot, or connected agent.

wher_record_item_sighting

From WHER to your AI

Connect once. Keep control in WHER.

01
Choose the access
Use browser-based OAuth where supported, or create a revocable personal token in WHER. Choose read-only or the exact write scopes you need.
02
Add the WHER server
Paste https://wher.ai/mcp into your AI client. It is the same Streamable HTTP endpoint everywhere.
03
Sign in, approve, ask
Approve the connection in WHER. Your workspace membership and scopes are checked again on every request.

Connection guide

Setup by client.

Server URLhttps://wher.ai/mcp

Claude · claude.ai and Claude Desktop

1
Open Settings, then Connectors.
2
Choose Add custom connector.
3
Paste the WHER server URL and add it.
4
Sign in to WHER and approve the requested scopes.

Connector availability can depend on your Claude plan and organization settings.

Server URL

https://wher.ai/mcp

OAuth keeps your WHER password out of the AI client. Revoke the connection whenever you need to.

Claude Code · terminal

1
Run the command in any project.
2
Open the MCP menu in Claude Code and choose WHER to sign in.
3
Approve the scopes in your browser, then ask about your inventory.

Run once

claude mcp add --transport http wher https://wher.ai/mcp

The tools appear under the WHER server. Reads and writes remain separated by scope.

Cursor · editor

1
Open Cursor Settings, then MCP.
2
Add a global MCP server and paste the JSON.
3
Save, then sign in to WHER when Cursor prompts you.

mcp.json

{
  "mcpServers": {
    "wher": {
      "url": "https://wher.ai/mcp"
    }
  }
}

Use OAuth when your Cursor version offers it. Personal tokens are available for clients that need explicit headers.

ChatGPT · custom app

1
Enable Developer mode for your account or workspace if your plan requires it.
2
In Settings → Apps, choose Create and enter the WHER endpoint.
3
Scan tools, complete the WHER OAuth prompt, and create the app.
4
Select WHER from the tools menu when a prompt needs your inventory.

Plan, role, region, model, and workspace controls can affect availability. Full write support currently depends on an eligible ChatGPT workspace.

Server URL

https://wher.ai/mcp

Review requested actions before approving them. WHER marks read and additive write tools separately.

Any client · remote MCP with OAuth

1
Add a remote Streamable HTTP MCP server with the WHER URL.
2
Let the client discover WHER OAuth and request the scopes you want.
3
Approve once in your browser. Revoke later from WHER.

Server URL

https://wher.ai/mcp

No OAuth support? Create a least-privilege personal token in WHER and send it as a Bearer authorization header.

Need a personal token instead?

In WHER, open Settings → AI & MCP Integrations. Create a read-only or read/write token, copy it once, and keep it out of prompts and shared files.

Open WHER settings

Permission by permission

Read is the baseline. Writes are separate.

WHER checks identity, workspace membership, and scope on every request. Start with inventory reads, then add only the write permissions your workflow needs.

With read access

It can remember with you

Search items by name and saved metadata
Browse locations, containers, and their contents
Read saved details, checkout status, and photos
Return stored directions and Open in WHER links
Resolve labels and read workspace usage

With explicit write scopes

It can help keep WHER current

Create an item in an existing container
Move an item and append movement history
Create a container in an existing location
Assign an unclaimed WHER label
Record an item sighting

No delete toolsThe MCP server cannot delete inventory.

Revocable accessConnections and personal tokens can be revoked.

Audited callsTool use is logged without raw arguments or inventory contents.

Protected writesWrites are scoped, additive, and idempotent.

WHER Pro

MCP is included with WHER Pro.

MCP integrations are included with WHER Pro and higher plans. Reads, searches, resources, prompts, item photos, spoken answers, and metadata suggestions use 0 Credits. A successful create, move, label, container, or sighting write uses 10 Credits; failed writes are automatically refunded.

The connector itself does not call a paid AI model, so WHER records zero provider tokens and zero provider cost for MCP tools.

Connect in WHER View plans

0Credits for reads

10Credits after a successful write

0Delete tools

Good to know

Before you connect.

For token management, scopes, and troubleshooting, open the full documentation inside WHER.

Open MCP documentation →

What is the WHER AI Connector?

It is WHER’s authenticated Model Context Protocol server. A compatible AI client can use WHER tools to search your workspace, read saved location context, show item photos, and—when separately authorized—make additive updates.

Is https://wher.ai/mcp a web page?

No. It is the machine endpoint for MCP clients. This page at https://wher.ai/ai/ is the human-readable setup guide, so the connector route stays stable and functional.

Can the AI change my inventory?

Only if the connection has the required write scope and the client allows the action. You can keep the connection read-only. WHER exposes additive create, move, label, container, and sighting tools, but no delete tools.

How does sign-in work?

OAuth-capable clients open WHER in your browser and use OAuth 2.1 with PKCE. Other clients can use a personal token created in WHER. Personal tokens expire within 90 days and are shown only once.

What does it cost?

The MCP feature requires WHER Pro or higher. Read operations use 0 Credits. A successful write uses 10 Credits, and a failed write is automatically refunded.

How do I disconnect it?

Open WHER’s AI & MCP Integrations settings and revoke the OAuth connection or personal token. WHER also rechecks account and workspace access on use, so removed or disabled memberships stop working.

WHER meets your AI

Use the inventory you already maintain.

Start read-only. Add write access only when you want your AI to help keep WHER current.

Choose your AI Open WHER settings

Ask your inventory from anywhere.

Useful questions, answered from your WHER records.

Walk straight to the right bin

Open a container without opening it

See everything in one place

Add an item where it belongs

Keep the last recorded place current

Understand or assign a label

Record where you just saw it

Connect once. Keep control in WHER.

Choose the access

Add the WHER server

Sign in, approve, ask

Setup by client.

Need a personal token instead?

Read is the baseline. Writes are separate.

It can remember with you

It can help keep WHER current

MCP is included with WHER Pro.

Before you connect.

Use the inventory you already maintain.