Connect Claude to your messages
Spaces gives Claude an MCP server for your messages. Once it's connected, Claude can list your chats, read messages, summarise what's unread and reply when you ask, within per-account limits Spaces enforces.
Let Claude set it up
Paste this into Claude Code, Claude Desktop or any agent that can browse and run commands.
Set me up on Spaces so you can read and send my messages. Instructions: https://www.spacesos.com/llms.txtTo give Claude Code the sign-up tools only (no key needed):
claude mcp add --transport http spaces-start https://api.spacesos.com/mcp/startClaude Code
Run this once in your terminal:
claude mcp add --transport http spaces https://api.spacesos.com/mcp --header "Authorization: Bearer spc_live_xxxxxxxxxxxxxxxx"Claude Desktop
Go to Settings → Developer → Edit Config, paste this into claude_desktop_config.json, then restart Claude:
{
"mcpServers": {
"spaces": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.spacesos.com/mcp",
"--header",
"Authorization:${SPACESOS_AUTH}"
],
"env": {
"SPACESOS_AUTH": "Bearer spc_live_xxxxxxxxxxxxxxxx"
}
}
}
}Claude API
Your own app on the Claude API connects through the MCP connector. From the Spaces docs:
import anthropic
client = anthropic.Anthropic()
response = client.beta.messages.create(
model="claude-opus-5-5",
max_tokens=16000,
betas=["mcp-client-2025-11-20"],
mcp_servers=[{
"type": "url",
"url": "https://api.spacesos.com/mcp",
"name": "spaces",
"authorization_token": "spc_live_xxxxxxxxxxxxxxxx",
}],
tools=[{"type": "mcp_toolset", "mcp_server_name": "spaces"}],
messages=[{"role": "user", "content": "Summarise my unread chats."}],
)
print(response.content)What Claude can do once connected
Every tool below is listed in the docs.
list_messaging_accountslist_messaging_chats(withunread)list_messaging_messagesget_messaging_attachmentreply_in_chatstart_chatget_profileget_messaging_billing
Each tool describes its own limits, so Claude can plan around them.
Which key should Claude get?
New keys can read and send. A read-only key is enough if Claude should only summarise or search your messages. You can pause, resume or revoke a key at any time.
Pricing
Questions, answered.
01Does Spaces work with Claude Code and Claude Desktop?
Yes. The Spaces docs give a one-line claude mcp add command for Claude Code and a claude_desktop_config.json entry for Claude Desktop.
02Can Claude sign me up?
Yes. Claude can use the onboarding MCP server to create your account and verify the code Spaces emails you. Then it opens checkout and a connect link for you to tap.
03Can Claude only read, not send?
Yes. Use a read-only key.
04What happens if Claude tries to send too much?
Spaces enforces per-account limits for every key. Over a limit, nothing is sent and Claude gets a Retry-After time.
05Is my key safe in the config file?
Treat it like a password. The key starts with spc_live_ and is shown once. Never paste it anywhere public. You can revoke it from the dashboard or the API.