Skip to main content
Glama

Nordic Thingy:52 MCP Server

by karthiksuku
GitHub
Python
  • Apple
  • Linux
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

šŸŽ® Nordic Thingy:52 MCP Server

License: MIT Python 3.10+ MCP

Control your Nordic Thingy:52 IoT device directly from Claude Desktop using the Model Context Protocol (MCP)

Transform your Claude Desktop into an IoT control center! This MCP server enables Claude to discover, connect to, and control Nordic Thingy:52 devices via Bluetooth LE - all through natural language conversation.

Nordic Thingy

āœØ Features

  • šŸ” Auto-Discovery: Scan for nearby Thingy devices

  • šŸ”Œ Easy Connection: Connect via Bluetooth LE with a single command

  • šŸ’” LED Control: Set RGB colors, create lighting effects

  • šŸ”Š Sound Control: Play built-in sounds and tones

  • šŸ“Š Sensor Reading: Monitor temperature, humidity, pressure, CO2, and TVOC

  • šŸ¤– AI Integration: Control everything through natural Claude conversations

  • šŸ”„ Real-time Updates: Instant feedback and status monitoring

šŸ“‹ Prerequisites

Hardware

  • Nordic Thingy:52 device (Purchase here)

  • Computer with Bluetooth LE support

  • Battery or USB power for Thingy

Software

  • Python 3.10 or higher

  • Claude Desktop app (Download here)

  • macOS (tested) or Linux with BlueZ (Windows support via bleak)

šŸš€ Quick Start

1. Installation

# Clone the repository git clone https://github.com/yourusername/mcp-server-nordic-thingy.git cd mcp-server-nordic-thingy # Create virtual environment python3 -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Install dependencies pip install -r requirements.txt

2. Configure Claude Desktop

Add the server to your Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "nordic-thingy": { "command": "python3", "args": ["/absolute/path/to/mcp_server_nordic_thingy.py"] } } }

3. Restart Claude Desktop

Close and reopen Claude Desktop to load the server.

4. Start Using!

Try these prompts in Claude:

"Find my Nordic Thingy and connect to it" "Turn the Thingy LED red" "Check the temperature and air quality" "Play a beep sound"

šŸ“– Documentation

Available Tools

Tool

Description

Example Prompt

thingy_scan

Discover nearby devices

"Scan for Thingy devices"

thingy_connect

Connect to a device

"Connect to XX:XX:XX:XX:XX:XX"

thingy_disconnect

Disconnect device

"Disconnect from Thingy"

thingy_set_led

Set RGB LED color

"Set LED to red"

thingy_led_off

Turn off LED

"Turn off the LED"

thingy_play_sound

Play sound (1-8)

"Play sound 3"

thingy_beep

Quick beep

"Make it beep"

thingy_get_sensors

Read all sensors

"Check all sensors"

thingy_get_status

Connection status

"Is Thingy connected?"

Sensor Data

The Thingy:52 provides:

  • šŸŒ”ļø Temperature (Ā°C)

  • šŸ’§ Humidity (%)

  • šŸ”½ Pressure (hPa)

  • šŸŒ«ļø CO2 (ppm) - Air quality

  • šŸŒ¬ļø TVOC (ppb) - Volatile organic compounds

  • šŸŽØ Color sensor (RGB + Clear)

šŸŽÆ Example Use Cases

1. Home Office Monitor

"Monitor my office air quality. Check CO2 every 5 minutes and alert me if it's unhealthy (>1000 ppm)"

2. Smart Notifications

"When you detect motion (temperature change), flash the LED blue and beep twice"

3. Temperature Alerts

"If the temperature goes above 25Ā°C, set the LED to red and play sound 5"

4. Mood Lighting

"Create a relaxing atmosphere: set the LED to a calm blue color"

5. Meeting Room Status

"Create a meeting room indicator: - Green LED: Good air quality, room available - Yellow LED: Moderate air quality - Red LED: Poor air quality, needs ventilation"

More examples in

šŸ› ļø Development

Project Structure

mcp-server-nordic-thingy/ ā”œā”€ā”€ mcp_server_nordic_thingy.py # Main MCP server ā”œā”€ā”€ requirements.txt # Python dependencies ā”œā”€ā”€ README.md # This file ā”œā”€ā”€ PROMPT_GUIDE.md # Comprehensive prompt examples ā”œā”€ā”€ CONTRIBUTING.md # Contribution guidelines ā”œā”€ā”€ LICENSE # MIT License ā”œā”€ā”€ examples/ # Example scripts ā”‚ ā”œā”€ā”€ basic_control.py ā”‚ ā”œā”€ā”€ sensor_monitor.py ā”‚ ā””ā”€ā”€ automation.py ā””ā”€ā”€ docs/ # Additional documentation ā”œā”€ā”€ API.md # API reference ā”œā”€ā”€ TROUBLESHOOTING.md # Common issues ā””ā”€ā”€ HARDWARE.md # Hardware details

Running Tests

# Install dev dependencies pip install -r requirements-dev.txt # Run tests pytest tests/ # Run with coverage pytest --cov=. tests/

Local Testing

Test the MCP server without Claude:

# Run server in test mode python3 mcp_server_nordic_thingy.py --test # Or use the test client python3 examples/test_client.py

šŸ¤ Contributing

We welcome contributions! Here's how you can help:

Ways to Contribute

  • šŸ› Report bugs

  • šŸ’” Suggest features

  • šŸ“ Improve documentation

  • šŸŽÆ Share useful prompts

  • šŸ”§ Submit pull requests

  • ā­ Star the repo!

Getting Started

  1. Fork the repository

  2. Create a feature branch (git checkout -b feature/AmazingFeature)

  3. Commit your changes (git commit -m 'Add AmazingFeature')

  4. Push to the branch (git push origin feature/AmazingFeature)

  5. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

Share Your Prompts!

Found a great way to use the Thingy? Share your prompts in PROMPT_GUIDE.md!

šŸ› Troubleshooting

Thingy Not Found

  1. Check Power: Ensure Thingy is powered on (blue LED should pulse)

  2. Bluetooth: Enable Bluetooth on your computer

  3. Distance: Keep Thingy within 10 meters

  4. Interference: Move away from other Bluetooth devices

  5. Reset: Hold Thingy button for 5 seconds to reset

Connection Failed

# Check Bluetooth status hcitool dev # Linux system_profiler SPBluetoothDataType # macOS # Scan manually hcitool lescan # Linux # Reset Bluetooth (macOS) sudo pkill bluetoothd

Claude Can't Find Server

  1. Check claude_desktop_config.json path is correct

  2. Verify Python path: which python3

  3. Check server logs in Claude Desktop Developer Tools

  4. Restart Claude Desktop

More troubleshooting in

šŸ“š Resources

Nordic Thingy:52

MCP (Model Context Protocol)

Claude Desktop

šŸŽ“ Learning Path

Beginners

  1. Read Quick Start

  2. Try basic prompts

  3. Explore sensor reading

Intermediate

  1. Create conditional automations

  2. Build sequences

  3. Monitor air quality

Advanced

  1. Multi-device control

  2. Database integration

  3. Web dashboard

  4. Custom tool development

šŸŒŸ Showcase

Community Projects

Smart Plant Monitor by @username

Automated plant care using humidity and temperature sensors

Home Lab Monitor by @username

Server room monitoring with multiple Thingys

Meeting Room Assistant by @username

Intelligent meeting room status indicator

Add your project! Submit a PR to appear here.

šŸ“Š Stats

  • šŸŒ”ļø 6 environmental sensors

  • šŸ’” 16.7 million LED colors

  • šŸ”Š 8 built-in sounds

  • āš” 30-day battery life

  • šŸ“” 10m Bluetooth range

  • šŸ”‹ 240 mAh Li-Po battery

šŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

MIT License Copyright (c) 2025 Nordic Thingy MCP Contributors Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software")...

šŸ™ Acknowledgments

  • Anthropic for Claude and MCP

  • Nordic Semiconductor for the amazing Thingy:52 hardware

  • Bleak library maintainers for excellent Bluetooth LE support

  • All contributors who make this project better

šŸ“ž Support

šŸ—ŗļø Roadmap

v1.0 (Current)

  • āœ… Basic Bluetooth LE connection

  • āœ… LED control

  • āœ… Sound playback

  • āœ… Sensor reading

  • āœ… MCP integration

v1.1 (Planned)

  • šŸ”„ Continuous sensor monitoring

  • šŸ“Š Data logging

  • šŸŒ Web dashboard

  • šŸ”” Smart alerts

  • šŸŽØ Advanced LED effects

v2.0 (Future)

  • šŸ¤– ML-based anomaly detection

  • šŸ  Home Assistant integration

  • šŸ“± Mobile app

  • šŸŒ Multi-Thingy coordination

  • ā˜ļø Cloud sync

Vote on features in

šŸŽ‰ Getting Started in 60 Seconds

# 1. Clone git clone https://github.com/yourusername/mcp-server-nordic-thingy.git cd mcp-server-nordic-thingy # 2. Install pip install -r requirements.txt # 3. Configure Claude (edit with your path) echo '{ "mcpServers": { "nordic-thingy": { "command": "python3", "args": ["'$(pwd)'/mcp_server_nordic_thingy.py"] } } }' > ~/Library/Application\ Support/Claude/claude_desktop_config.json # 4. Restart Claude Desktop # 5. Try it! # In Claude: "Find my Thingy and turn it red"

Built with ā¤ļø by the Nordic Thingy MCP community

If you find this useful, please ā­ star the repository!

ā¬† Back to top

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables Claude to control Nordic Thingy:52 IoT devices via Bluetooth LE, allowing users to manage LED colors, play sounds, and read environmental sensors through natural language conversations.

  1. āœØ Features
    1. šŸ“‹ Prerequisites
      1. Hardware
      2. Software
    2. šŸš€ Quick Start
      1. 1. Installation
      2. 2. Configure Claude Desktop
      3. 3. Restart Claude Desktop
      4. 4. Start Using!
    3. šŸ“– Documentation
      1. Available Tools
      2. Sensor Data
    4. šŸŽÆ Example Use Cases
      1. 1. Home Office Monitor
      2. 2. Smart Notifications
      3. 3. Temperature Alerts
      4. 4. Mood Lighting
      5. 5. Meeting Room Status
    5. šŸ› ļø Development
      1. Project Structure
      2. Running Tests
      3. Local Testing
    6. šŸ¤ Contributing
      1. Ways to Contribute
      2. Getting Started
      3. Share Your Prompts!
    7. šŸ› Troubleshooting
      1. Thingy Not Found
      2. Connection Failed
      3. Claude Can't Find Server
    8. šŸ“š Resources
      1. Nordic Thingy:52
      2. MCP (Model Context Protocol)
      3. Claude Desktop
    9. šŸŽ“ Learning Path
      1. Beginners
      2. Intermediate
      3. Advanced
    10. šŸŒŸ Showcase
      1. Community Projects
    11. šŸ“Š Stats
      1. šŸ“„ License
        1. šŸ™ Acknowledgments
          1. šŸ“ž Support
            1. šŸ—ŗļø Roadmap
              1. v1.0 (Current)
              2. v1.1 (Planned)
              3. v2.0 (Future)
            2. šŸŽ‰ Getting Started in 60 Seconds

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/karthiksuku/nordic-thingy-mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server