Follow Plan

Follow Plan MCP Server is a complete backend for intelligent project planning and task management. It stores tasks, features, bugs, and rules in SQLite with full-text search, while providing automatic synchronization and backup capabilities to help you manage projects efficiently in an AI-enabled workflow.

How to use

You connect to the MCP server from your MCP client to manage tasks, features, bugs, and rules. Use the client to create, update, and search items across your project. You can run automatic synchronization to keep the in-memory view aligned with the filesystem, and you can back up or restore the database when needed. Perform searches across all plan items to quickly locate relevant information, and use the rule engine to enforce project constraints and automate common actions.

How to install

Prerequisites: ensure you have Node.js installed on your system. You will also need npm to install dependencies and run scripts.

# Install dependencies
npm install

# Build the project
npm run build

# Start the MCP server (replace /path/to/your/project with your project path)
npm start /path/to/your/project

Additional configuration and usage notes

The server stores its data under a .plan directory inside your project path. The key components include the SQLite database, task/feature/bug files, rules, and logs for temporary files.

Environment variables you can configure to tailor behavior include LOG_LEVEL to control logging verbosity, PLAN_AUTO_SYNC to enable or disable automatic synchronization, and PLAN_BACKUP_INTERVAL to set how often backups occur. Provide example values to guide your setup.

Data management and tools

You have tools to manage different plan items and to perform searches. Use the task, feature, bug, and rule operations to create, update, retrieve, list, and delete records. Use the search tools to perform a general or advanced search across all plan items, and use backup and restore tools to manage database state.

Available tools

create_task

Create a new task with details such as title, description, due date, priority, and status.

update_task

Update an existing task identified by ID, including status, priority, and progress.

get_task

Retrieve full details for a task by its ID.

list_tasks

List tasks with optional filters such as status, priority, or assignee.

delete_task

Delete a task by its ID.

create_feature

Create a new feature or user story with associated epics and acceptance criteria.

update_feature

Update an existing feature's attributes and progress.

get_feature

Get details for a feature by ID.

list_features

List features with optional filters.

delete_feature

Delete a feature by ID.

create_bug

Report a new bug with reproduction steps, severity, and status.

update_bug

Update an existing bug by ID, including status and priority.

get_bug

Retrieve details for a bug by ID.

list_bugs

List bugs with optional filters such as severity or status.

delete_bug

Delete a bug by ID.

create_rule

Create a new project rule, validation, or automation guideline.

update_rule

Update an existing rule by ID.

get_rule

Get rule details by ID.

list_rules

List rules with optional filters.

delete_rule

Delete a rule by ID.

search

Search across all plan items with full-text relevance scoring.

advanced_search

Perform an advanced search using filters across tasks, features, bugs, and rules.

backup_database

Create a local backup of the SQLite database.

restore_database

Restore the database from a backup file.

sync_filesystem

Synchronize database state to the filesystem and ensure consistency.