What is MCP?
Model Context Protocol (MCP) is an open standard that lets AI tools connect to external data sources. Think of it as a universal plug — once an AI tool supports MCP it can connect to any MCP server with just a URL, and your AI can access BatteryOS data natively without switching tabs.
Before you start
You'll need a BatteryOS account. You will authenticate your AI tool using your existing BatteryOS credentials via a secure OAuth2 flow. The same email and password you use on the platform will work here — no new passwords required.
How to Connect
1. Connect via Claude.ai (Web)
The simplest setup for teams and individual users.
For Admins (organisation-wide):
- Sign in to claude.ai as an organisation admin.
- Go to Organisation Settings → Connectors.
- Click Add → Custom → Web.
- Name:
BatteryOS - Remote MCP Server URL:
https://mcp.batteryos.com/sse/sse - Save. Everyone in your org will see BatteryOS in their connector list and can authenticate individually.
For Individual Users:
- In Claude, go to Settings → Connectors → BatteryOS.
- Click Connect.
- You'll be redirected to BatteryOS to sign in and authorise.
- Once authenticated, BatteryOS appears in the tools menu when you start a new chat.
2. Connect via Claude Desktop
For power users running Claude locally on macOS or Windows. Add the following to your claude_desktop_config.json:
{
"mcpServers": {
"BatteryOS": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://mcp.batteryos.com/sse/sse"
]
}
}
}Config file location (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
3. Connect via Claude Code (CLI)
Anthropic's command-line tool — perfect for developers and terminal-based workflows.
Add BatteryOS to your current project:
claude mcp add batteryos --transport http https://mcp.batteryos.com/sse/sse
Then open a fresh Claude Code session, type /mcp, scroll to BatteryOS, and follow the authentication link.
4. Other MCP Clients (Cursor, Windsurf, etc.)
Point any MCP-compatible tool to the server URL below. Setup steps vary by tool, but every client accepts the same URL:
https://mcp.batteryos.com/sse/sse