Skip to main content

MCP Integration

Vigilare includes a built-in Model Context Protocol (MCP) server, allowing AI assistants like Claude to interact directly with your tasks.

What is MCP?​

The Model Context Protocol (MCP) is a standard that enables AI models to connect to external tools and data sources. By enabling Vigilare's MCP server, you allow AI assistants to:

  • Read your tasks and lists
  • Create new tasks
  • Update task details and status
  • Add comments to tasks
  • Manage lists (create, archive)

This is a powerful feature for users who want to automate their task management or use AI for planning and review.

Configuration​

To use Vigilare with Claude Code or Claude Desktop, you need to add Vigilare to your MCP settings file.

1. Locate your settings file​

For Claude Code (CLI), the configuration file is typically located at: ~/.claude/settings.json

For Claude Desktop, look for: ~/Library/Application Support/Claude/claude_desktop_config.json

2. Add the configuration​

Add the following entry to the mcpServers object in your configuration file. You can verify the exact path to your Vigilare executable in Settings → MCP Configuration.

{
  "mcpServers": {
    "vigilare": {
      "command": "/Applications/Vigilare.app/Contents/MacOS/Vigilare",
      "args": ["--mcp"]
    }
  }
}

Note: If you installed Vigilare in a different location, update the "command" path accordingly.

3. Restart Claude​

After saving the configuration file, restart Claude (Desktop or CLI) to load the new tool definitions.

Available Tools​

Vigilare provides a comprehensive set of tools for task management.

Reading Data​

  • vigilare_get_lists: Get all task lists and their incomplete task counts. Use include_archived to also show archived lists.
  • vigilare_get_reminders: Fetch tasks with filters (today, overdue, all). Use from/to date range to review completed tasks.
  • vigilare_get_reminder: Get full details of a specific task, including notes and comments.
  • vigilare_search_reminders: Search tasks by keyword in title or notes across all lists.

Task Management​

  • vigilare_create_reminder: Create a new task with title, notes, due date, priority, and list.
  • vigilare_update_reminder: Update specific fields of a task (title, notes, due date, priority, list). Use "none" for due_date to clear it.
  • vigilare_set_reminder_status: Change task status — complete, reopen, drop (abandon), or wait (on hold).
  • vigilare_add_comment: Add a text comment to a task's history.

List Management​

  • vigilare_create_list: Create a new list.
  • vigilare_archive_list: Hide a list from the main view.
  • vigilare_unarchive_list: Restore an archived list.

System​

  • vigilare_ping: Check if the server is running.
  • vigilare_get_settings: Check current app configuration.

Use Cases​

Daily Review: Ask Claude: "Summarize what I completed yesterday and what's overdue today."

Quick Capture: Ask Claude: "Add a high priority task to 'Work' list: 'Prepare Q3 Report' due next Friday."

Project Planning: Ask Claude: "Create a list 'Project X' and add tasks for the initial phase."