How do I use belong-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@belong-mcp Show me today's visitor approvals" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

belong-mcp

by arjun1194

Overview Schema Related Servers Score Discussions

JavaScript

Remote

Belong MCP Server

An MCP (Model Context Protocol) server that exposes the Belong Resident Application APIs as tools. This lets AI assistants like Claude interact with your Belong society account -- manage visitors, vehicles, maintenance issues, amenity bookings, finances, and more.

Prerequisites

Node.js v18 or later
An active Belong resident account

Related MCP server: actual-mcp

Setup

Clone the repo

git clone https://github.com/arjunbhasin/belong-mcp.git
cd belong-mcp

Install dependencies
```
npm install
```
Create a .env file (optional -- you can authenticate via OTP through the MCP tools instead)
```
cp .env.example .env
```
If you already have tokens, populate them:
```
ACCESS_TOKEN=your_access_token
REFRESH_TOKEN=your_refresh_token
MOBILE_NUMBER=your_mobile_number
```

Running the Server

The server communicates over stdio, which is how MCP clients (like Claude Code or Claude Desktop) connect to it.

node index.js

Or using the npm script:

npm start

Connecting to Claude Code

Add to your Claude Code MCP config (~/.claude/claude_code_config.json or project-level .mcp.json):

{
  "mcpServers": {
    "belong-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/belong-mcp/index.js"]
    }
  }
}

Connecting to Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "belong-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/belong-mcp/index.js"]
    }
  }
}

Authentication

There are two ways to authenticate:

Option 1: OTP via MCP tools (recommended)

Once the server is connected, use the built-in authentication tools:

Call request_otp with your mobile number
Call verify_otp with the OTP you received
Tokens are saved to .env automatically

Option 2: Manual `.env` file

If you have tokens from another session, add them to the .env file directly (see Setup step 3).

The server automatically refreshes expired access tokens using the refresh token.

Available Tools

Authentication

Tool	Description
`request_otp`	Send OTP to mobile number
`verify_otp`	Verify OTP to complete login
`check_auth_status`	Check current auth state

Profile & Flats

Tool	Description
`get_resident_profile`	Get your profile (name, mobile, email)
`get_flat_access`	Get flat feature flags and access details
`get_occupancy_detail`	Get tower/wing/floor info for a flat
`list_flats`	List all your associated flats
`list_flats_by_occupancy`	Filter flats by occupancy ID
`get_flats_by_resident_ids`	Look up flats for specific residents

Visitors & Gate

Tool	Description
`get_visitor_approvals`	List gate entries for a date
`get_approvals_count`	Monthly visitor approval count
`get_exit_passes`	Material movement exit passes
`get_entry_stats`	Visitor entry statistics
`list_visitor_companies`	Delivery companies by category

Staff & Services

Tool	Description
`list_service_staffs`	Registered staff (maid, cook, etc.)
`list_service_staff_bookings`	Staff booking schedules
`list_service_types`	Available service types

Vehicles

Tool	Description
`list_resident_vehicles`	Vehicles registered to a flat
`search_vehicles`	Search by registration number
`list_vehicle_brands`	Available vehicle brands

Maintenance Issues

Tool	Description
`list_maintenance_issues`	Your complaints and issues
`list_issue_categories`	Available issue categories
`get_issue_stats`	Issue statistics

Amenities

Tool	Description
`list_booked_slots`	Amenity bookings (gym, pool, etc.)
`get_booking_stats`	Booking statistics

Community

Tool	Description
`get_announcements`	Community announcements
`list_community_feeds`	Community feed posts
`get_banners`	Promotional banners
`list_campaigns`	Active campaigns
`list_rwa_members`	RWA committee members

Buggy Service

Tool	Description
`list_buggy_stops`	Golf cart pickup/drop stops
`get_buggy_activity`	Buggy ride history

Chat

Tool	Description
`list_chat_enabled_residents`	Residents available for chat
`list_chat_wings`	Wings available for chat
`list_chat_flat_residents`	Residents on a floor

Infrastructure

Tool	Description
`get_towers`	Buildings in a project
`get_module_access`	Enabled modules/features
`list_external_services`	Integrated services (laundry, food)
`list_languages`	Available languages

Finance & Billing

Tool	Description
`get_financial_ledger`	Transaction history for a date range
`get_invoice_stats`	Unpaid amounts, interest, balance
`list_demandnote_requests`	Payment demands from management
`get_payment_config`	Payment method configuration

Notifications & Delivery

Tool	Description
`get_notifications_count`	Unread notification count
`get_delivery_preferences`	Auto-approve delivery settings

License

ISC

Install Server

license - not found

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

openapi-mcp-bridge
Developer Tools API Testing
sssdavid529
A
license
-
quality
A
maintenance
Turns any OpenAPI/Swagger API into MCP tools, enabling AI assistants to call REST API endpoints directly.
Last updated 2026-05-31
2
MIT
actual-mcp
Finance
slushpupie
F
license
A
quality
C
maintenance
Bridges AI/LLM applications to Actual Budget, exposing budget data as MCP tools for account listing, transactions, and budget balances.
Last updated 2026-06-08
4
Halo ITSM MCP Server
Customer Support Project Management
omichelbraga
F
license
-
quality
C
maintenance
Enables AI-driven IT service management by exposing the full Halo ITSM REST API through 172 tools across 43 resource domains to any MCP-compatible client.
Last updated 2026-07-27
1
yellow-pages
RAG Systems Developer Tools
ethank64
F
license
A
quality
D
maintenance
Exposes two MCP tools (discover and execute) that enable agents to query an OpenAPI schema via natural language and execute matched API operations.
Last updated 2026-03-18
2

View all related MCP servers

Related MCP Connectors

CryptoCultCurt-appfolio-mcp-server
Provide seamless access to Appfolio Property Manager Reporting API through a standardized MCP serv…
bounty-api
Singapore property & financial data APIs for AI agents. 27 MCP tools. x402 micropayments.
SRG+
Manage SRG+ hubs, channels, content, assets, users, and workspaces from any MCP-aware AI agent.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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/arjun1194/belong-mcp'

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

Belong MCP Server

Prerequisites

Setup

Running the Server

Connecting to Claude Code

Connecting to Claude Desktop

Authentication

Option 1: OTP via MCP tools (recommended)

Option 2: Manual .env file

Available Tools

Authentication

Profile & Flats

Visitors & Gate

Staff & Services

Vehicles

Maintenance Issues

Amenities

Community

Buggy Service

Chat

Infrastructure

Finance & Billing

Notifications & Delivery

License

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

openapi-mcp-bridge

actual-mcp

Halo ITSM MCP Server

yellow-pages

Related MCP Connectors

Latest Blog Posts

MCP directory API

Option 2: Manual `.env` file