🎄 Holiday Sale: 50% OFF on UI Initiative, Swiper Studio, PaneFlow and t0ggles 🎄
Documentation/

MCP Server

The t0ggles MCP (Model Context Protocol) Server enables AI assistants to interact with your boards, projects, tasks, and notes. Connect your favorite AI-powered development tools to manage your work directly through natural language conversations.

#Quick Start

Get up and running with t0ggles MCP in three simple steps:

#1. Generate an MCP Token

  1. Go to your Account Settings
  2. Find the MCP Tokens section
  3. Give it a descriptive name and click Generate Token
  4. Copy the generated token immediately - you won't be able to see it again

💡 Tip: Learn more about token management in the MCP Tokens documentation.

#2. Configure Your AI Tool

Add the t0ggles MCP server to your AI tool's configuration. See the Integration Guides section for specific tools.

#3. Start Using Natural Language

Once configured, you can interact with t0ggles using natural language:

"Show me all my t0ggles boards"
"Create a high-priority task 'Review API changes' in the Backend project"
"What tasks are assigned to me in the Marketing board?"

#Available Tools

The MCP server provides 17 tools organized by functionality:

#Board Operations

  • list-boards - List all boards you have access to, returning board IDs, URLs, titles, and images
  • get-board - Get detailed information about a specific board including tags, properties, and settings

#Project Operations

  • list-projects - List all active (non-archived) projects in a board, including the special "OTHER" project
  • get-project - Get detailed information about a specific project including AI context, tags, and links

#Status Operations

  • list-statuses - Get all statuses (Kanban columns) for a board with their colors, types, and order
  • get-status - Get a single status by ID with its details

#User Operations

  • list-users - List all users who have access to a board with their display names and emails

#Task Operations

  • list-tasks - List tasks in a board or project with optional filtering by project, status, or parent task
  • get-task - Get full details of a specific task including description, comments count, and properties
  • search-tasks - Search tasks by title with optional project filtering
  • get-task-by-url - Get a task by its full URL (supports custom domains)
  • create-task - Create a new task with optional subtasks, custom properties, and automatic task automations
  • update-task - Update an existing task's title, status, priority, assignment, dates, and properties

#Note Operations

  • search-notes - Search notes by title in a board
  • list-notes - List notes in a board with optional parent folder filtering
  • get-note - Get full note details including Markdown content
  • get-note-by-url - Get a note by its full URL (supports custom domains)
  • create-note - Create a new note or folder with optional icon and parent folder
  • update-note - Update an existing note's title, content, icon, or parent folder

#Integration Guides

#Cursor IDE

Cursor has native MCP support. Add t0ggles to your MCP configuration:

Configuration file location: ~/.cursor/mcp.json

{
  "mcpServers": {
    "t0ggles": {
      "url": "https://t0ggles.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

After saving, restart Cursor to load the MCP server.

#VS Code

VS Code has built-in MCP support with GitHub Copilot. Configure it in your user or workspace settings:

Configuration file location: .vscode/mcp.json (workspace) or User Settings

{
  "inputs": [
    {
      "type": "promptString",
      "id": "t0ggles-token",
      "description": "t0ggles MCP Token",
      "password": true
    }
  ],
  "servers": {
    "t0ggles": {
      "type": "http",
      "url": "https://t0ggles.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:t0ggles-token}"
      }
    }
  }
}

VS Code will prompt you for the token when the server first connects. Learn more at VS Code MCP documentation.

#Claude Code

For Claude Code, use the CLI to add the t0ggles MCP server:

claude mcp add --transport http t0ggles https://t0ggles.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN_HERE"

Learn more at Claude Code MCP documentation.

#OpenAI Codex

For OpenAI Codex, use the CLI to add the t0ggles MCP server:

codex mcp add t0ggles -- curl -H "Authorization: Bearer YOUR_TOKEN_HERE" https://t0ggles.com/mcp

Or configure in your config.toml. Learn more at Codex MCP documentation.

#Opencode

Add t0ggles to your Opencode configuration file (opencode.json):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "t0ggles": {
      "type": "remote",
      "url": "https://t0ggles.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Learn more at Opencode MCP documentation.

#Usage Examples

Here are practical examples and prompts to help you get the most out of t0ggles MCP integration:

#Task Management

List and organize tasks:

  • "Show me all tasks in the Marketing board"
  • "What are my high-priority tasks?"
  • "List all in-progress tasks assigned to me"

Create tasks:

  • "Create a task 'Design new landing page' in the Website project with high priority"
  • "Add a bug fix task 'Fix login timeout issue' with tags 'Bug' and 'Urgent'"
  • "Create a task with subtasks: 'Launch feature X' with subtasks 'Write tests', 'Update docs', 'Deploy to staging'"

Update tasks:

  • "Mark task PROJ-123 as done"
  • "Assign the 'API refactor' task to sarah@company.com"
  • "Change the priority of MARKETING-45 to high and add a due date for next Friday"

#Project & Board Overview

Get project context:

  • "Give me an overview of the Backend project"
  • "What are the active projects in my Work board?"
  • "Show me the kanban columns for the Design board"

Search and find:

  • "Search for tasks related to 'authentication'"
  • "Find all tasks in the BACKEND project about API"
  • "What tasks mention 'performance'?"

#Note Management

Create and organize notes:

  • "Create a note titled 'Meeting Notes - Sprint Planning' in the Documentation folder"
  • "Add a new folder called 'Technical Specs' to the notes"
  • "Create a note with the technical design for the new authentication system"

Search and retrieve:

  • "Find notes about 'deployment'"
  • "Get the content of the 'Architecture Overview' note"
  • "List all notes in the Onboarding folder"

#Development Workflows

Sprint planning:

  • "List all tasks in the current sprint (TODO and In Progress status)"
  • "Create tasks for: 'Implement user settings', 'Add dark mode toggle', 'Fix mobile navigation'"
  • "What tasks need code review?"

Bug tracking:

  • "Show me all tasks tagged with 'Bug'"
  • "Create a high-priority bug: 'Users cannot reset password on mobile'"
  • "How many open bugs do we have in the Frontend project?"

Daily standups:

  • "What did I complete yesterday? (tasks moved to Done)"
  • "What's assigned to me that's still in progress?"
  • "Are there any blocked tasks?"

#Advanced Prompts

Batch operations:

"Create the following tasks in the Onboarding project:

  1. Set up development environment
  2. Read coding guidelines
  3. Complete security training
  4. Meet with team lead"

Context-aware assistance:

  • "Based on the tasks in BACKEND project, what seems to be the current priority?"
  • "Summarize the status of the Website Redesign project"
  • "What tasks are overdue in my boards?"

#Security

#Token Security

  • Single-view tokens: MCP tokens can only be viewed once at creation - store them securely
  • Revoke anytime: Tokens can be revoked immediately from your Account Settings
  • Account-bound: Each token is tied to your user account and respects your board permissions
  • Token limit: Maximum of 10 tokens per user account
  • Usage tracking: Last used timestamp is tracked for each token

#Best Practices

  1. Use descriptive names for tokens to identify their purpose (e.g., "Cursor IDE - Work Laptop")
  2. Rotate tokens periodically for enhanced security
  3. Revoke unused tokens to minimize exposure
  4. Never share tokens - generate separate tokens for each tool/device
  5. Store tokens securely using environment variables or secret managers

#API Endpoints

  • MCP Protocol Endpoint - POST https://t0ggles.com/mcp - Returns server status and version information.
  • Health Check Endpoint - GET https://t0ggles.com/mcp/health - Returns server status and version information.
  • Server Info Endpoint - GET https://t0ggles.com/mcp/info - Returns server capabilities and available tools.
Account
Delete Account