{"version":3,"summary":"Tallyhand provides time tracking, invoicing, expenses and contractor workspace management through a REST API, a Streamable HTTP MCP server, and the tally CLI. Install standalone CLI binaries from the setup guide; no npm package is published.","credentials":{"tallyhand_api_key":{"type":"api_key","label":"Tallyhand personal API key","generateUrl":"https://tallyhand.xyz/settings/connect","setup":"Sign in at https://tallyhand.xyz/settings/connect and create a personal API key. Send it in Authorization: Bearer. For the CLI, install from https://tallyhand.xyz/docs#cli, run tally config set api-url https://tallyhand.xyz, then tally login to paste the key into a hidden prompt. Alternatively set TALLYHAND_API_URL and TALLYHAND_API_TOKEN. The CLI stores login keys in ~/.tallyhand/config.json; protect this file. Hosted access covers the signed-in owner's cloud workspace, not browser-only offline data."},"tallyhand_oauth":{"type":"oauth2","label":"Tallyhand delegated OAuth access","generateUrl":"https://tallyhand.xyz/docs/integrations","setup":"Discover the authorization server at https://tallyhand.xyz/.well-known/oauth-protected-resource/api/mcp. Use authorization code with S256 PKCE, consent and resource https://tallyhand.xyz/api/mcp in authorization and token requests. Request tally:read, adding tally:write or tally:manage for the actions needed; offline_access requests refresh tokens. Compatible clients can use client ID metadata documents; manual clients can be registered in Settings → Connect → OAuth applications. Send the resulting access token in Authorization: Bearer. Browser-session JWTs are not OAuth access tokens. The same resource-bound token authorizes scoped REST workspace operations; it cannot administer OAuth clients."}},"surfaces":[{"slug":"tallyhand-api","name":"Tallyhand REST API","type":"http","url":"https://tallyhand.xyz/api/v1","spec":"https://tallyhand.xyz/openapi.yaml","specAlternates":["https://tallyhand.xyz/openapi.json"],"docs":"https://tallyhand.xyz/docs/integrations","basis":{"via":"declared","source":"https://tallyhand.xyz/.well-known/integrations.json"},"auth":{"status":"required","entries":[{"use":[{"id":"tallyhand_api_key","mechanics":{"source":"http","in":"header","headerName":"Authorization","scheme":"Bearer"}}],"basis":{"via":"declared","source":"https://tallyhand.xyz/.well-known/integrations.json"}},{"use":[{"id":"tallyhand_oauth","mechanics":{"source":"http","in":"header","headerName":"Authorization","scheme":"Bearer"}}],"basis":{"via":"declared","source":"https://tallyhand.xyz/.well-known/integrations.json"}}]},"notes":"JSON envelopes, pagination, idempotent mutations and dry-run previews. OAuth access is limited to scoped workspace operations; credential and OAuth-client management requires browser sign-in."},{"slug":"tallyhand-mcp","name":"Tallyhand MCP server","type":"mcp","url":"https://tallyhand.xyz/api/mcp","transports":["streamable-http"],"docs":"https://tallyhand.xyz/docs#mcp","basis":{"via":"declared","source":"https://tallyhand.xyz/.well-known/integrations.json"},"auth":{"status":"required","entries":[{"use":[{"id":"tallyhand_api_key","mechanics":{"source":"http","in":"header","headerName":"Authorization","scheme":"Bearer"}}],"basis":{"via":"declared","source":"https://tallyhand.xyz/.well-known/integrations.json"}},{"use":[{"id":"tallyhand_oauth","mechanics":{"source":"well-known"}}],"basis":{"via":"declared","source":"https://tallyhand.xyz/.well-known/integrations.json"}}]},"notes":"Stateless Streamable HTTP. No standalone GET stream or session IDs. Local stdio access is available through tally mcp after CLI configuration."},{"slug":"tallyhand-cli","name":"Tallyhand CLI","type":"cli","command":"tally","docs":"https://tallyhand.xyz/docs#cli","basis":{"via":"declared","source":"https://tallyhand.xyz/.well-known/integrations.json"},"auth":{"status":"required","entries":[{"use":[{"id":"tallyhand_api_key","mechanics":{"source":"cli","command":"tally login","env":["TALLYHAND_API_TOKEN"]}}],"basis":{"via":"declared","source":"https://tallyhand.xyz/.well-known/integrations.json"}}]},"notes":"Standalone binaries, not an npm package. macOS/Linux installer: https://tallyhand.xyz/setup.sh (inspect before executing). Windows binaries: https://github.com/pkyanam/tallyhand/releases. Configure tally config set api-url https://tallyhand.xyz or TALLYHAND_API_URL. tally login prompts for a personal API key, not an OAuth browser login. tally --help discovers commands; --json returns structured output; tally mcp serves local stdio MCP."}]}