StashDog MCP Server

A server providing natural language tools to manage your StashDog inventory.

A Model Context Protocol (MCP) server that provides natural language tools for managing your StashDog inventory. This server enables AI assistants to interact with your StashDog inventory through intuitive natural language commands.

- Natural Language Interface: Use plain English to manage your inventory
- Comprehensive Item Management: Add, update, search, delete, and organize items
- Collection Management: Create and manage collections with ease
- Smart Search: Intelligent search across your inventory with complex queries
- Tag Management: Create, rename, and organize tags
- URL Import: Import items directly from URLs
- Authentication: Secure authentication with your StashDog account
- Rich Formatting: Beautiful, formatted responses with emojis and structured data
-

Clone or downloadthis MCP server to your local machine:

git clone <repository-url> cd stashdog-mcp-server

cp .env.example .env # Edit .env with your StashDog API configuration

Create a.envfile in the root directory:

# StashDog Supabase Configuration STASHDOG_SUPABASE_URL=http://localhost:54321 STASHDOG_SUPABASE_ANON_KEY=your_anon_key_here STASHDOG_AUTH_TOKEN=your_auth_token_here # Optional: Pre-configured credentials STASHDOG_EMAIL=your_email@example.com STASHDOG_PASSWORD=your_password

This server only uses user access tokens for requests. Do not provide a service role key.

Add this server to your.cursor/mcp.jsonor similar MCP client configuration:

{ "mcpServers": { "stashdog": { "command": "node", "args": ["/path/to/stashdog-mcp-server/dist/index.js"], "env": { "STASHDOG_SUPABASE_URL": "http://localhost:54321", "STASHDOG_SUPABASE_ANON_KEY": "your_anon_key_here", "STASHDOG_AUTH_TOKEN": "your_token_here" } } } }

Authenticate with your StashDog account.

authenticate with email: user@example.com and password: mypassword

Add, update, search, delete, or manage inventory items using natural language.

- "Add a new MacBook Pro with tags electronics, work, expensive"
- "Search for items tagged with kitchen"
- "Update item abc123 to add note about warranty expiring soon"
- "Delete item xyz789"
- "Find all storage containers"
- "Add item called 'Wireless Mouse' with notes 'Logitech MX Master 3' and tags office, electronics"

Create, update, delete collections or manage items within collections.

- "Create a new collection called 'Kitchen Appliances'"
- "Add items abc123, def456 to collection xyz789"
- "Delete collection old-stuff"
- "Update collection xyz789 to change name to 'Home Office'"

Import items from URLs (product pages, images, etc.).

import_from_url: https://example.com/product/laptop

- "Create tag electronics"
- "Search for tags containing kitchen"
- "Rename tag old-name to new-name"
- "Delete tag unused-tag"

Perform intelligent searches with natural language queries.

- "Show me all electronics in the office"
- "Find kitchen items that are favorited"
- "List storage containers with more than 5 items"

- "Fetch all unread notifications"
- "Get notifications with a limit of 10"

Manage subscriptions including fetching details and creating subscriptions.

- "Get subscription details for US in USD"
- "Create a subscription with tier PREMIUM"

Add a new item called "Gaming Keyboard" with notes "Mechanical switches, RGB lighting" and tags gaming, electronics, desk-setup

Find all items tagged with electronics that are in storage containers

Create a new collection called "Home Office Setup" with description "Everything needed for working from home"

Search for items with tags kitchen, appliances limit 10

The server includes sophisticated natural language parsing that understands:

- Actions: add, create, update, modify, delete, remove, search, find, favorite, etc.
- Tags: Supports#hashtagformat and comma-separated lists
- Item IDs: Automatically detects UUIDs in various formats
- Custom Fields: Parsesfield_name: valuepatterns
- Storage Indicators: Recognizes storage/container keywords
- Quotes: Handles quoted names and descriptions
- Limits and Offsets: Understands pagination keywords

The server supports multiple authentication methods:
- Environment Token: SetSTASHDOG_AUTH_TOKENin your environment
- Runtime Authentication: Use theauthenticatetool to log in
- Auto-login: ConfigureSTASHDOG_EMAILandSTASHDOG_PASSWORDfor automatic authentication

All responses follow a consistent format:

{ "success": true, "message": "✅ Successfully added item 'Gaming Keyboard' with ID: abc123", "data": { "id": "abc123", "name": "Gaming Keyboard", "tags": ["gaming", "electronics", "desk-setup"] } }

The server provides detailed error messages for common scenarios:

- Missing required parameters
- Authentication failures
- Network connectivity issues
- Supabase REST errors
- Validation errors

stashdog-mcp-server/ ├── src/ │ ├── index.ts # Main MCP server │ ├── client.ts # Supabase REST client wrapper │ ├── types.ts # TypeScript types │ ├── nlp-utils.ts # Natural language processing │ └── graphql/ │ └── operations.ts # Legacy GraphQL queries (unused) ├── dist/ # Compiled JavaScript ├── package.json ├── tsconfig.json ├── .env.example └── README.md

- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request

MIT License - see LICENSE file for details.
- Check that your StashDog API is running and accessible
- Verify your authentication credentials
- Check the server logs for detailed error messages
- Ensure all dependencies are properly installed

# Authenticate authenticate with email: user@example.com and password: mypassword # Add some items Add a new MacBook Pro with tags electronics, work, laptop and notes "16-inch, M2 chip, 32GB RAM" # Create a collection Create a new collection called "Work Equipment" with description "All items for remote work" # Search for items Find all items tagged with electronics # Get stats get_inventory_stats # Import from URL import_from_url: https://example.com/product/wireless-mouse # Smart search Show me all work-related items that are favorited

This MCP server makes managing your StashDog inventory as easy as having a conversation with an AI assistant!

Perform queries and entity operations in your Fibery workspace.

Execute Beancount queries and submit transactions to a ledger.

Access and manage your Bear Notes from a local SQLite database.

Automated expense management with a Supabase backend and hierarchical category support.

Turn the spreadsheets running your business into secure applications.

An MCP server for accessing JIRA issue data stored in Snowflake.

A read-only MCP server for Jira, enabling LLMs to query live Jira data using the CData JDBC Driver.

An AI-powered chat server for tracking job interview processes, integrated with Supabase.

A simple note-taking server for recording and managing notes with AI models, using AWS DynamoDB for storage.

Service account inventory for developers — which email owns which Supabase, Vercel, or Stripe — kept current by your coding agents over MCP; stores metadata, never secrets.