Looking to integrate your Sparrow wallet with Bitcoin-only accounting software for seamless tax reporting? This guide walks you through connecting both single-sig and multisig Sparrow wallets to Clams, automatically syncing your transaction history and calculating accurate cost basis for Bitcoin accounting.
Why Connect Sparrow Wallet to Clams?
Sparrow is one of the best Bitcoin wallets available, and when paired with Clams' Bitcoin-only accounting software, you get:
- Automatic transaction syncing using Extended Public Keys (Xpubs) and Descriptors
- Privacy - your wallet data stays on your device
- Lightning-fast setup - connect in under 2 minutes
- No address hunting - Clams automatically derives all your addresses
- Tax-ready reports - with accurate cost basis calculations
Before You Start
What You'll Need:
- Sparrow Wallet installed and set up
- Your wallet's Extended Public Key (Xpub) or Descriptor
- Clams installed
If you have not set Clams up yet, install it and initialize your books:
curl -sSL https://clams.tech/install.sh | sh
clams init
Important: Clams only needs your Xpub/Descriptor (read-only access). Clams never needs your private keys or seed phrase.
Single-Sig Wallet Setup
Step 1: Export Your Xpub from Sparrow
- Open Sparrow and select your wallet
- Go to Settings → Keystores
- Right-click on the xpub/ypub/zpub value and Copy the Extended Public Key (starts with
xpub,ypub, orzpub)
Step 2: Add Your Xpub to Clams
Create an XPub connection, replacing YOUR_XPUB with the value you copied from Sparrow:
clams connections create \
--label my-sparrow \
--kind XPub \
--configuration '{"xpub":"YOUR_XPUB","address_types":["bech32"]}'
Adjust address_types to match the script types your wallet uses (for example bech32 for native SegWit or bech32m for Taproot). Then sync to discover your addresses and import history, and process the results into journal entries:
clams connections sync --label my-sparrow
clams journals processMultisig Wallet Setup
Step 1: Export Your Multisig Descriptor
- In Sparrow, open your multisig wallet
- Go to Settings → Script Policy
- Right-click and copy the full Output Descriptor (includes all co-signer Xpubs)
Step 2: Add Your Descriptor to Clams
Create a Descriptor connection, replacing YOUR_DESCRIPTOR with the output descriptor you copied from Sparrow:
clams connections create \
--label my-sparrow-multisig \
--kind Descriptor \
--configuration '{"descriptor":"YOUR_DESCRIPTOR"}'
Then sync and process:
clams connections sync --label my-sparrow-multisig
clams journals processPro Tips for Sparrow + Clams
Once your Sparrow wallets are connected Clams will automatically:
- Derive all addresses associated with your Xpub / Descriptor wallets
- Scan for transaction history
- Calculate cost basis for every transaction and for the balance as a whole
- Display your complete transaction history
- Automatically detect, label and account for transfers between your connected wallets
Best Practices:
- Always verify you're copying the Xpub / Descriptor, not private keys
- Consider using different Sparrow wallets for different purposes (spending vs savings)
Organization Tips:
- Use descriptive wallet names in Clams that match your Sparrow setup
- Label transactions in both Sparrow and Clams for better record-keeping
- Set up separate wallets for business vs personal Bitcoin
Troubleshooting:
- If transactions aren't appearing for your Xpub, make sure you are scanning for all addresses types that you know have balances.
- For multisig, make sure you copied the full descriptor, not just one cosigner's Xpub.
Next Steps
- Review imported transactions for accuracy
- Add custom labels to improve organization
- Set up additional connections to capture all your Bitcoin transactions
- Generate tax reports when needed:
clams reports capital-gains --format csvNeed Help?
Having trouble with your Sparrow integration? We're here to help:
- Join our Matrix community
- Email us directly: hello@clams.tech