pndr

# Pndr Pndr is your personal productivity command center, now accessible to AI agents via MCP (Model Context Protocol). ## What You Can Do With Pndr's MCP integration, AI assistants like Claude can: - **Manage your tasks** - Add, edit, complete, and organize ideas with tags and priorities - **Track your habits** - Create daily habits and mark them complete automatically - **Journal** - Record thoughts and retrieve them with fuzzy search - **Track packages** - Monitor deliveries with tracking numbers and carriers - **Manage lists** - Create checklists, shopping lists, or any collection of items - **Get insights** - View today's focus items, kanban boards, accomplishments, and patterns All of this happens in your own private Pndr account - the AI just provides a natural language interface to your data. ## How It Works Pndr exposes your personal productivity data through the Model Context Protocol (MCP), allowing AI assistants to interact with your tasks, habits, and journal on your behalf. **Example conversations:** - "Add a task to call mom tomorrow with high priority" - "What's on my plate today?" - "Mark my exercise habit as complete" - "Show me my accomplishments this week" - "Add a journal entry about today's meeting" The AI uses Pndr's MCP tools behind the scenes to read and write your data securely. ## Who Is This For? This integration is perfect if you: - Use an AI assistant (Claude, OpenClaw, etc.) and want it to manage your tasks - Want natural language access to your productivity data - Like the idea of saying "add this to my todo list" instead of opening an app - Already use Pndr and want to access it through AI conversations ## Prerequisites - A Pndr account (sign up at https://pndr.io) - An AI assistant that supports MCP (like Claude Desktop or OpenClaw) - For manual setup: `mcporter` CLI tool ## Setup ### For OpenClaw Users OpenClaw can set this up automatically! Just ask your assistant: > "Connect to my Pndr account" Then provide your Pndr OAuth credentials when prompted. ### Manual Setup 1. **Get Pndr API credentials:** - Log in to https://pndr.io - Go to Settings → API → Create OAuth Client - Give it a name (e.g., "My AI Assistant") - Copy your `client_id` and `client_secret` 2. **Get an access token:** ```bash curl -X POST https://pndr.io/oauth/token \ -H "Content-Type: application/json" \ -d '{ "grant_type": "client_credentials", "client_id": "pndr_client_YOUR_CLIENT_ID", "client_secret": "YOUR_CLIENT_SECRET" }' ``` This returns a JSON response with an `access_token`. Copy it. 3. **Add to your MCP client config:** For **mcporter** (`config/mcporter.json`): ```json { "mcpServers": { "pndr": { "baseUrl": "https://pndr.io/mcp", "headers": { "Authorization": "Bearer YOUR_ACCESS_TOKEN" } } } } ``` For **Claude Desktop** (`claude_desktop_config.json`): ```json { "mcpServers": { "pndr": { "url": "https://pndr.io/mcp", "headers": { "Authorization": "Bearer YOUR_ACCESS_TOKEN" } } } } ``` 4. **Test the connection:** ```bash mcporter list pndr --schema ``` You should see 47 available tools! ## Available Tools ### Ideas & Tasks - `add_idea` - Create a new idea/task - `list_ideas` - List and filter ideas - `edit_idea` - Edit an existing idea - `complete_idea` - Mark an idea as completed - `delete_idea` - Delete an idea - `categorize_idea` - Update tags on an idea - `set_work_status` - Set work status (not started, in progress, blocked) - `get_kanban` - Get kanban board view - `get_today` - Get today's focus items ### Journal & Thoughts - `add_thought` - Record a journal/diary entry - `get_thoughts` - Retrieve thoughts with fuzzy search - `delete_thought` - Delete a thought ### Habits - `add_habit` - Create a new daily habit - `list_habits` - List all habits with completion status - `complete_habit` - Mark a habit as completed for today - `uncomplete_habit` - Undo a habit completion - `update_habit` - Update habit text or resources - `archive_habit` - Archive (delete) a habit ### Checklists - `add_checklist_item` - Add a checklist item to an idea - `complete_checklist_item` - Mark checklist item as completed - `uncomplete_checklist_item` - Mark checklist item as not completed - `get_checklist` - Get all checklist items for an idea - `edit_checklist_item` - Edit checklist item text - `delete_checklist_item` - Delete a checklist item ### Lists - `add_list` - Create a new list - `list_lists` - Get all lists with optional filtering - `get_list` - Get a single list with items - `update_list` - Update list name, description, or tags - `delete_list` - Delete a list and all its items - `add_list_item` - Add an item to a list - `update_list_item` - Update list item text, notes, or completion - `toggle_list_item` - Toggle list item completion - `delete_list_item` - Remove an item from a list - `reorder_list_items` - Change item order in a list ### Packages - `add_package` - Track a new package delivery - `list_packages` - List tracked packages - `update_package` - Update package information - `mark_package_delivered` - Mark a package as delivered - `delete_package` - Delete a package from tracking ### Tags - `list_tags` - List all available tags - `create_tag` - Create a new tag - `delete_tag` - Delete a tag ### Comments - `add_comment` - Add a comment to an idea - `list_comments` - List comments on an idea - `delete_comment` - Delete a comment ### Attachments - `list_attachments` - List attachments for an idea - `get_attachment` - Get attachment metadata - `download_attachment` - Download attachment with base64 data ### Analytics - `get_accomplishments` - Get summary of completed tasks and habits - `get_patterns` - Analyze patterns in ideas and thoughts over time ## Usage Examples Once connected, you can interact with Pndr naturally through your AI assistant: **Task Management:** - "Add a high-priority task to finish the presentation by Friday" - "Show me all my work tasks that are in progress" - "Mark task [ID] as complete" - "What should I focus on today?" **Habits:** - "Did I complete my exercise habit today?" - "Mark my reading habit as done" - "What's my current streak for meditation?" **Journaling:** - "Add a journal entry: Had a breakthrough on the project today" - "What was I thinking about last week around this topic?" - "Show me my thoughts from January" **Package Tracking:** - "Track a package from Amazon, tracking number 1Z999..." - "What packages am I expecting?" - "Mark my laptop package as delivered" **Lists:** - "Create a grocery list" - "Add milk and eggs to my shopping list" - "Show me my reading list" ### Direct CLI Usage (Advanced) If you're using mcporter directly: ```bash # Add a task mcporter call pndr.add_idea text="Build a new feature" tags:work,coding priority:P1 # Check today's focus mcporter call pndr.get_today # Complete a habit mcporter call pndr.complete_habit habit-id:abc123 # Add journal entry mcporter call pndr.add_thought content="Had a great day working on the project" # View kanban board mcporter call pndr.get_kanban tags:work ``` ## Authentication Pndr uses OAuth 2.0 client credentials flow. Access tokens expire after 1 year (365 days). To refresh your token, repeat the `curl` command from step 2 and update your mcporter config with the new Bearer token. ## Source Code Open source at https://github.com/Dgershman/pndr ## Pricing - Free tier: Read-only access - Pro ($5/mo or $48/year): Full read/write access ## Support - Documentation: https://pndr.io/docs - Issues: https://github.com/Dgershman/pndr/issues