youspot

The official Python client for YouSpot, the AI-native personal CRM. It is the twin of the youspot npm package: same endpoints, same rules about what needs a credential.

No dependencies. Standard library only.

pip install youspot

Ask without a credential

import youspot

youspot.ask("what does youspot cost")
youspot.search_docs("mcp oauth")
youspot.read_markdown("/pricing")
youspot.index()

Try the tools without an account

https://youspot.com/mcp/sandbox runs the read tools against a demo account whose contacts and interactions are generated. No signup, no credits, and every tool that writes is refused there.

youspot.sandbox_tools()
youspot.call_sandbox_tool("search_graph_objects", {"query": "consulting"})

Call a member's own tools

Every tool reads one person's CRM, so this needs their token. Mint one at youspot.com/user/mcp and set YOUSPOT_TOKEN, or run the OAuth 2.1 flow described in auth.md.

youspot.tools()
youspot.call_tool("search_graph_objects", {"query": "acme"})
youspot.identity("service_auth", token="...")

Errors

Everything raises youspot.YouSpotError, which carries .status, .code and a readable message.

try:
    youspot.call_tool("search_graph_objects", {"query": "acme"})
except youspot.YouSpotError as error:
    print(error.code, error)

Configuration

The machine description of every endpoint is at youspot.com/openapi.json.