top of page

Connect Claude to
SensorHubb

User Guide for Claude Desktop and Claude.ai

​

What This Does: Connect Claude AI to your SensorHubb sensor data so you can ask questions, analyze trends, detect anomalies, and get insights about your temperature monitoring system using natural language

​​

Prerequisites

  • SensorHubb Account: Your administrator must create a user account with your email address and enable OAuth for your account

  • Google Account: Your SensorHubb email must be linked to a Google account (Gmail or Google Workspace)

  • Claude Access: Either Claude Desktop app OR access to claude.ai Important: You do NOT need to log into the SensorHubb web application first.
     

Authentication happens automatically through Google when you connect Claude.​

​

How Authentication Works

When you connect Claude to SensorHubb:​

​

1. Claude redirects you to Google's secure login page
2. You sign in with your Google account (same email as your SensorHubb account) 3. Google returns an authentication token to Claude
4. Claude sends the token to SensorHubb to verify your identity

5. SensorHubb verifies your email and grants Claude access to your sensor data

​​

All data access is scoped to your user account - you only see sensors and locations you have permission to access in SensorHubb.

​

Connecting from Claude Desktop

​

1. Open Settings​

  • Launch Claude Desktop

  • Click on your name in the bottom left corner

  • Select Settings

 

​

2. Go to Connectors

  • In the Settings window, click the Connectors tab

  • Click Add Custom Connector

​

3. Add SensorHubb

 

​

4. Connect and Authenticate

  • After adding the connector, you'll see it in your Connectors list

  • Click the Connect button next to SensorHubb

  • You'll be redirected to Google's login page

  • Sign in with your Google account (must match your SensorHubb email exactly)

  • Grant permission when prompted

  • You'll be redirected back to Claude Desktop

  • If successful, the connector will show as "Connected"

​

Test Your Connection: Start a new conversation and ask: "Use my SensorHubb MCP to show me what sensors I have access to" or "Use SensorHubb MCP to show me my latest temperature readings"

 

Pro Tip: Mention "SensorHubb MCP" at the beginning of your conversation so Claude knows to use it. After the first mention, you can just ask questions normally.

​

Connecting from Claude.ai (Web)

1. Open Settings​

  • Go to claude.ai and sign in

  • Click on your name in the bottom left corner

  • Select Settings

 

​

2. Go to Connectors

  • In the Settings window, click the Connectors tab

  • Click Add Custom Connector

​

3. Add SensorHubb

 

​

4. Connect and Authenticate

  • After adding the connector, you'll see it in your Connectors list

  • Click the Connect button next to SensorHubb

  • You'll be redirected to Google's login page

  • Sign in with your Google account (must match your SensorHubb email exactly)

  • Grant permissions when prompted

  • You'll be returned to Claude.ai

  • If successful, the connector will show as "Connected"

​

Test Your Connection: Start a new conversation and ask: "Use my SensorHubb MCP to show me a summary of my sensor fleet health" or "Use SensorHubb MCP to show me which sensors have recent alerts"

Pro Tip: Mention "SensorHubb MCP" at the beginning of your conversation so Claude knows to use it. After the first mention, you can just ask questions normally.

​

​

 

What You Can Ask Claude

Sensor Queries

  • What sensors do I have access to?

  • Show me the latest temperature readings for all my sensors

  • Which sensors are currently offline or have low battery?

  • What's the current temperature in my walk-in cooler?

  • Show me all door sensors that are currently open

​

Analytics & Insights

  • Analyze temperature trends for [sensor name] over the past week

  • Are there any temperature anomalies in my sensor data?

  • What's the health status of my sensor fleet?

  • Which sensors have the most events or alerts?

  • Show me sensors with poor signal strength or connectivity issues

  • What sensors had temperature violations in the last 24 hours?

​

Reporting & Summaries

  • Create a statistical summary for [sensor name] from [start date] to [end date]

  • Show me hourly temperature rollups for the past 24 hours

  • What were the min/max/average temperatures for my freezer yesterday?

  • Generate a daily summary for all my temperature sensors

​

​

Troubleshooting

"User not found" or "OAuth not enabled"

 

Problem: After authenticating with Google, you see an error about your user not being found or OAuth not being enabled.

 

Solution:

  • Verify your Google email EXACTLY matches your SensorHubb user email (case-sensitive)

  • Contact your SensorHubb administrator to confirm:

  •  Your user account exists in SensorHubb

  • OAuth is enabled for your account

  • Your account status is set to "ENABLED"

​

Connection Timeout or Server Not Responding

Problem: Claude can't reach the SensorHubb server or connection times out.

 

Solution:

  • Verify the URL is exactly: https://dev.sensorhubb.com/api/mcp

  • Check your internet connection

  • Try removing the connector and adding it again

  • Contact SensorHubb support to verify the server is running

​

Authentication Fails or Token Exchange Error

Problem: Google authentication succeeds but Claude still can't access SensorHubb data

 

Solution:

  • Make sure you're using the SAME email for both Google and SensorHubb

  • Try signing out of Claude and signing back in

  • Remove the SensorHubb connector completely and add it again from scratch

  • Clear your browser cache if using claude.ai

  • Contact SensorHubb support if the issue persists

​

Tools Not Showing Up or "No Tools Available"

Problem:  Claude doesn't offer SensorHubb tools or says no tools are available.

 

Solution:

  • Verify the connector was added successfully (check Settings → Connectors)

  • Try starting a brand new conversation

  • For Claude Desktop: completely quit and restart the application

  • Re-authenticate by clicking the authenticate button again

​

Security & Privacy

Data Security

  • Encryption: All communication uses HTTPS/TLS encryption

  • Access Control: You only see sensors, accounts, and locations you have permission to access in SensorHubb

  • Read-Only Access: Claude cannot modify, delete, or create sensor data, alerts, or configurations

  • Session-Based: Authentication tokens expire and must be renewed periodically

​

What Google Can See

  • SensorHubb uses Google OAuth only for authentication (verifying your identity)

  • Google knows you logged into SensorHubb, but does NOT see any of your sensor data

  • No temperature readings, alerts, or sensor information is shared with Google

​

Reporting & Data Export

  • Faster report generation for accounts with thousands of sensors

  • Improved PDF formatting and layout

  • More accurate data in account summary reports

  • CSV, XLSX, and PDF exports show only relevant data based on sensor capabilities

  • Better formatted export files for analysis

  • Improved chart export functionality

User Interface

  • Detail pages now use 90% width (max 1200px) for better screen utilization

  • Responsive tables work beautifully on all screen sizes

  • Better data visualization throughout the application

  • Enhanced status indicators

  • Improved mobile experience with better touch targets

​

​

Disconnecting Claude from SensorHubb

1. Go to Settings → Connectors (in Claude Desktop or claude.ai)

2. Find "SensorHubb" in your connector list
3. Click Remove or Delete

 

To revoke Google OAuth access completely:

1. Go to Google Account Security
2. Navigate to "Third-party apps with account access"

3. Find "SensorHubb" and click "Remove Access"

Modified Endpoints

  • Event filtering endpoints now support multiple simultaneous event types

  • Query parameter format updated for better compatibility

  • Enhanced error responses with detailed messages

​

Support

  • Technical Issues or Errors: support@sensorhubb.com

  • Account Setup or Permissions: Contact your SensorHubb administrator

  • OAuth Configuration: Contact SensorHubb support

  • Server URL: https://dev.sensorhubb.com/api/mcp

  • Authentication: Google OAuth 2.1 (via Auth0)

  • Document Version: 1.0 | Last Updated: November 2025

bottom of page