List available tasks on the TODO list

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://bump.sh/bump-examples/hub/code-samples/doc/to-do-list/mcp

Standard setup for AI tools providing an mcp.json file

      
          mcp.json

"To do list MCP server": {
  "url": "https://bump.sh/bump-examples/hub/code-samples/doc/to-do-list/mcp"
}

GET /tasks

Oauth2

Lists tasks that have been created, with a default filter of 'new' and 'in progress' tasks unless specified otherwise

Query parameters

status string

Filters the list of tasks by the status provided

Responses

200 application/json

Returns a list of Tasks, with any request filters applied
Hide response attributes Show response attributes object
- id integer
  
  The unique identifier for a task.
- description string
  
  A brief summary of the task.
- status string
  
  The current status of the task, which can be 'new', 'in progress', or 'completed'.
  
  Values are new, in progress, or completed. Default value is new.

GET /tasks

curl \
 --request GET 'https://api.todolist.local/v1/tasks' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

[
  {
    "id": 1,
    "description": "Buy milk",
    "status": "completed"
  },
  {
    "id": 2,
    "description": "Send email to John",
    "status": "in progress"
  }
]