Documentation
Model Context Protocol (MCP) Integration
Overview
Connect Claude Desktop directly to your AskRobots account with our official MCP server. Manage tasks, organize files, and leverage AI—all through natural language.
🗂️ Task Management
Create, update, and complete tasks directly from Claude
📁 File Organization
Categorize and manage files with simple commands
🤖 AI Integration
Analyze code and generate task descriptions
Quick Start
2 Simple Steps:
- Get your API token: Create Token
-
Add MCP server to Claude Code:
claude mcp add askrobots https://askrobots.com/api/mcp/ -t http -H "Authorization: Token YOUR_TOKEN"
That's it! No npm install required. The MCP server runs on our infrastructure.
Installation
Prerequisites
- Claude Code CLI (
claudecommand available) - AskRobots account with API token
One-Line Setup
No npm install needed - the MCP server runs on our infrastructure:
claude mcp add askrobots https://askrobots.com/api/mcp/ -t http -H "Authorization: Token YOUR_TOKEN"
Replace YOUR_TOKEN with your actual API token.
Configuration
1. Get Your API Token
Visit your API Tokens page and create a new token. Name it "Claude Code" for easy identification.
2. Add MCP Server
Run this command in your terminal:
claude mcp add askrobots https://askrobots.com/api/mcp/ -t http -H "Authorization: Token YOUR_TOKEN"
3. Test Connection
Start Claude Code and try: "List my open tasks"
Usage Examples
Task Management
"Show my open tasks""Create a task: Review pull requests""Mark task abc123 as complete""Add comment to task: Waiting on client"
File Management
"List uncategorized files""Categorize file as financial/invoices""Show PDF files from this week""Get download link for file xyz"
Notes & Knowledge
"Create note: Meeting notes...""Save this link: https://...""Search notes for API""Create article about deployment"
AI Features
"Analyze this code: [paste]""Generate tasks for user auth""Suggest next steps for project""Create 5 QA test tasks"
Available Tools (19 total)
global_search- Search across all content (projects, tasks, notes, contacts, files, links, articles)
list_projects- List all projects (filter by status: active, completed, all)create_project- Create a new project (name, description, status)
list_tasks- List tasks with filters (project, status, urgency)get_task- Get task details including commentscreate_task- Create a new taskupdate_task- Update task (move project, change title/urgency)add_task_comment- Add a comment to a taskclaim_task- Claim an open task for workingsubmit_task- Submit completed work for approvalcomplete_task- Mark a task as complete
list_contacts- List contacts with searchget_contact- Get contact detailscreate_contact- Create a new contactupdate_contact- Update contact info
create_note- Create a quick note (optionally attached to project)create_link- Save a bookmark/linkcreate_article- Create a longer-form article
get_dashboard_stats- Get AI operations dashboard statistics (wallet, API usage, tasks)
Troubleshooting
Common Issues
- Verify your API token is correct
- Check token hasn't been revoked
- Ensure you're using the production URL
- Add npm global bin to PATH:
export PATH="$PATH:$(npm bin -g)" - Or use full path in Claude configuration
- Check MCP server is in Claude settings
- Restart Claude Desktop
- Check logs in Console.app (Mac) or Event Viewer (Windows)
Pricing & Limits
| Plan | MCP Access | API Rate Limit | Monthly Operations |
|---|---|---|---|
| Free | ❌ Not available | - | - |
| Pro | ✅ Full access | 60 requests/minute | 10,000 operations |
| Enterprise | ✅ Full access | 300 requests/minute | Unlimited |
Need Help?
Check our community forum or email support@askrobots.com