{"_id":"@brandcast_app/google-tasks-mcp","name":"@brandcast_app/google-tasks-mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@brandcast_app/google-tasks-mcp","version":"0.1.0","description":"Model Context Protocol (MCP) server for Google Tasks - enables AI assistants to manage tasks","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","bin":{"google-tasks-mcp":"dist/index.js","google-tasks-mcp-auth":"dist/auth.js"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"build":"tsc","dev":"tsc --watch","clean":"rm -rf dist","auth":"ts-node src/auth.ts","test":"NODE_OPTIONS=--experimental-vm-modules jest","test:watch":"NODE_OPTIONS=--experimental-vm-modules jest --watch","test:coverage":"NODE_OPTIONS=--experimental-vm-modules jest --coverage","lint":"eslint src --ext .ts","type-check":"tsc --noEmit","prepublishOnly":"npm run clean && npm run build"},"keywords":["mcp","model-context-protocol","google-tasks","tasks","ai","claude","assistant","productivity"],"author":{"name":"Jamie Duncan","email":"jamie@brandcast.app"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/BrandCast-Signage/tasks-mcp-server.git"},"bugs":{"url":"https://github.com/BrandCast-Signage/tasks-mcp-server/issues"},"homepage":"https://github.com/BrandCast-Signage/tasks-mcp-server#readme","engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","googleapis":"^144.0.0"},"devDependencies":{"@types/jest":"^29.5.14","@types/node":"^18.19.68","@typescript-eslint/eslint-plugin":"^8.18.0","@typescript-eslint/parser":"^8.18.0","eslint":"^8.57.1","jest":"^29.7.0","ts-jest":"^29.2.5","ts-node":"^10.9.2","typescript":"^5.3.3"},"_id":"@brandcast_app/google-tasks-mcp@0.1.0","gitHead":"552ad6e2c3ac9a97152af2c4310f08f720ff8aa4","_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-Or4Z7flvP+lb278T7yNN3Sm6bPXoT9ZEXE3uQ+MNdZ9LKyoiu7BubbQ3N9fgCWN8dlxlOlCer3ZvBvjDz4wO3g==","shasum":"69ff145b40d67e27e2c1caadf54f2291803dceac","tarball":"https://registry.npmjs.org/@brandcast_app/google-tasks-mcp/-/google-tasks-mcp-0.1.0.tgz","fileCount":79,"unpackedSize":102790,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDu1yPi8GV0/VDF0QowWuVNw5z9ryL3FuU4CZUGqxdiiwIgerue+kvQ9Wlu9Oi5HtnoEx24UkR/NSuJlvYhHxGp7SE="}]},"_npmUser":{"name":"jamieeduncan","email":"jamie@brandcast.app"},"directories":{},"maintainers":[{"name":"jamieeduncan","email":"jamie@brandcast.app"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/google-tasks-mcp_0.1.0_1759777442535_0.11385406392748632"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-06T19:04:02.450Z","0.1.0":"2025-10-06T19:04:02.719Z","modified":"2025-10-06T19:04:03.001Z"},"maintainers":[{"name":"jamieeduncan","email":"jamie@brandcast.app"}],"description":"Model Context Protocol (MCP) server for Google Tasks - enables AI assistants to manage tasks","homepage":"https://github.com/BrandCast-Signage/tasks-mcp-server#readme","keywords":["mcp","model-context-protocol","google-tasks","tasks","ai","claude","assistant","productivity"],"repository":{"type":"git","url":"git+https://github.com/BrandCast-Signage/tasks-mcp-server.git"},"author":{"name":"Jamie Duncan","email":"jamie@brandcast.app"},"bugs":{"url":"https://github.com/BrandCast-Signage/tasks-mcp-server/issues"},"license":"MIT","readme":"# Google Tasks MCP Server\n\n<p align=\"center\">\n  <strong>Model Context Protocol (MCP) server for Google Tasks</strong><br>\n  Enable AI assistants like Claude to manage your Google Tasks\n</p>\n\n---\n\n## 🚀 Quick Start\n\n### 1. Create Google OAuth Credentials\n\n1. Go to [Google Cloud Console](https://console.cloud.google.com/)\n2. Create a new project (or select existing)\n3. Enable the **Google Tasks API**:\n   - Navigate to \"APIs & Services\" > \"Library\"\n   - Search for \"Tasks API\"\n   - Click \"Enable\"\n4. Create OAuth 2.0 credentials:\n   - Go to \"APIs & Services\" > \"Credentials\"\n   - Click \"Create Credentials\" > \"OAuth client ID\"\n   - Choose \"Desktop app\" as the application type\n   - Name it \"Google Tasks MCP\" (or whatever you prefer)\n   - Click \"Create\"\n5. Download or copy the **Client ID** and **Client Secret**\n\n### 2. Install the Package\n\n```bash\nnpm install -g @brandcast_app/google-tasks-mcp\n```\n\n### 3. Get Your Refresh Token\n\nRun the authentication script:\n\n```bash\n# Set your credentials\nexport GOOGLE_CLIENT_ID=\"your_client_id_here\"\nexport GOOGLE_CLIENT_SECRET=\"your_client_secret_here\"\n\n# Run auth flow\nnpx @brandcast_app/google-tasks-mcp auth\n```\n\nThis will:\n1. Open your browser\n2. Ask you to authorize the app\n3. Display your configuration to copy\n\n### 4. Configure Claude Desktop\n\nAdd to your config file:\n\n**macOS/Linux:** `~/.config/Claude/claude_desktop_config.json`  \n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"google-tasks\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@brandcast_app/google-tasks-mcp\"],\n      \"env\": {\n        \"GOOGLE_CLIENT_ID\": \"your_client_id_here\",\n        \"GOOGLE_CLIENT_SECRET\": \"your_client_secret_here\",\n        \"GOOGLE_REFRESH_TOKEN\": \"your_refresh_token_here\"\n      }\n    }\n  }\n}\n```\n\n### 5. Restart Claude Desktop\n\nCompletely quit and relaunch Claude Desktop.\n\n---\n\n## 📋 Available Tools\n\nAsk Claude to:\n\n- **\"Show my task lists\"** - List all your Google Tasks lists\n- **\"Show tasks from [list name]\"** - Get tasks from a specific list\n- **\"Create a task 'Buy milk' in my Shopping list\"** - Create new tasks\n- **\"Mark task [id] as complete\"** - Complete tasks\n- **\"Search for tasks about 'report'\"** - Search across all lists\n- **\"Show me all my tasks\"** - Sync all tasks from all lists\n\nThe MCP server provides 9 tools:\n1. `listProviders` - Get available providers\n2. `listTaskLists` - Get all task lists\n3. `getTasks` - Get tasks from a list\n4. `createTask` - Create a new task\n5. `updateTask` - Update existing task\n6. `completeTask` - Mark task complete\n7. `deleteTask` - Delete a task\n8. `searchTasks` - Search across lists\n9. `syncAllTasks` - Get all tasks\n\n---\n\n## 🔧 Development\n\n### Local Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/BrandCast-Signage/tasks-mcp-server.git\ncd tasks-mcp-server\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run auth flow\nexport GOOGLE_CLIENT_ID=\"your_id\"\nexport GOOGLE_CLIENT_SECRET=\"your_secret\"\nnpm run auth\n```\n\n### Testing Locally\n\nUpdate Claude Desktop config to use local build:\n\n```json\n{\n  \"mcpServers\": {\n    \"google-tasks\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/tasks-mcp-server/dist/index.js\"],\n      \"env\": {\n        \"GOOGLE_CLIENT_ID\": \"...\",\n        \"GOOGLE_CLIENT_SECRET\": \"...\",\n        \"GOOGLE_REFRESH_TOKEN\": \"...\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## 📖 Documentation\n\n- [API Documentation](./docs/API.md) - Complete tool reference\n- [Claude Desktop Setup](./docs/CLAUDE_DESKTOP_SETUP.md) - Detailed setup guide\n\n---\n\n## 🔐 Security Notes\n\n- Tokens are stored only in Claude Desktop's config file\n- Refresh tokens are used to automatically get new access tokens\n- The MCP server doesn't persist any credentials to disk\n- All communication happens locally via stdio\n\n---\n\n## 🐛 Troubleshooting\n\n### \"Provider not found\" error\n- Make sure Claude Desktop is completely restarted\n- Check the config file path is correct\n- Verify JSON syntax is valid\n\n### Authentication errors\n- Run `npm run auth` again to get a fresh refresh token\n- Make sure Client ID and Secret match your Google Cloud project\n- Verify the Tasks API is enabled in Google Cloud Console\n\n### \"Command not found\"  \n- Make sure the package is installed: `npm install -g @brandcast_app/google-tasks-mcp`\n- Or use npx: `npx @brandcast_app/google-tasks-mcp`\n\n---\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n\n## 👥 Contributing\n\nContributions welcome! Please open an issue or PR.\n\n---\n\n## 🔗 Related Projects\n\n- [Model Context Protocol](https://modelcontextprotocol.io/)\n- [Google Tasks API](https://developers.google.com/tasks)\n- [BrandCast](https://brandcast.app) - Digital signage platform\n\n---\n\n**Author:** Jamie Duncan ([@BrandCast-Signage](https://github.com/BrandCast-Signage))\n\n**Version:** 0.1.0 (MVP - Google Tasks only)\n","readmeFilename":"README.md","_rev":"1-515dc9bd95fc497d01136601d4ecb57d"}