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