Tool Stack Agent

An AI agent that keeps your Notion Tool Stack database up to date. It reads your existing tools, researches new ones via Claude, and writes suggestions back to Notion with Status = "Testing".

---

Setup

1. Install dependencies

pip install -r requirements.txt

2. Add your API keys to .env

ANTHROPIC_API_KEY=sk-ant-...
NOTION_API_KEY=secret_...
NOTION_DATABASE_ID=bd4ca803-382d-4ad2-8735-6795c6a2ccf6

3. Connect your Notion integration to the Tool Stack DB

• Go to your 🧰 Tool Stack database in Notion
• Click ... → Connections → Add your integration ("Toolbox Agent")

---

Usage

# Full run: research new tools + flag stale ones
python main.py

# Preview suggestions without writing to Notion
python main.py --dry-run

# Only check which tools haven't been reviewed recently
python main.py --stale-only

---

Scheduling (optional)

Mac/Linux — run every Sunday at 9am

Add to crontab (crontab -e):

0 9 * * 0 cd /path/to/toolbox-agent && python main.py >> agent.log 2>&1

GitHub Actions — free cloud scheduling

Create .github/workflows/toolbox.yml:

name: Toolbox Agent
on:
  schedule:
    - cron: '0 9 * * 0'  # Every Sunday 9am UTC
jobs:
  run:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-python@v4
        with:
          python-version: '3.11'
      - run: pip install -r requirements.txt
      - run: python main.py
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
          NOTION_API_KEY: ${{ secrets.NOTION_API_KEY }}
          NOTION_DATABASE_ID: ${{ secrets.NOTION_DATABASE_ID }}

---

File Structure

toolbox-agent/
├── main.py           # Entry point — run this
├── notion_db.py      # Read/write Notion DB
├── agent.py          # Claude-powered research logic
├── config.py         # API keys + DB schema constants
├── requirements.txt
├── .env              # Your secret keys (never commit this)
└── README.md