Work Item Manager supports the Model Context Protocol (MCP), allowing AI assistants like Claude to interact with your project data directly.
What is MCP?
MCP is a protocol that enables AI assistants to discover and use tools exposed by applications. With MCP integration, AI can:
- Create, read, update, and manage work items
- Create and edit wiki pages
- Manage folders and project structure
- Add comments to work items
Setting Up MCP
1. First, generate a Personal Access Token from your Profile Settings.
2. Add the following to your MCP configuration file (e.g., .mcp.json):
{
"mcpServers": {
"projectmanager": {
"type": "stdio",
"command": "node",
"args": ["/path/to/mcp-server/dist/index.js"],
"env": {
"PM_API_URL": "http://localhost:3002",
"PM_API_TOKEN": "your-token-here"
}
}
}
}
Available MCP Tools
Once configured, the following tools are available to AI assistants:
Pages
get_page - Get a wiki page by its 6-digit code
create_page - Create a new wiki page
update_page - Update an existing page
delete_page - Delete a page
list_pages - List all pages in the project
Folders
get_folder - Get a folder by its 4-digit code
list_folders - List all folders
create_folder - Create a new folder
get_folder_tree - Get folder structure with contents
Work Items
get_workitem - Get a work item by its 6-digit code
list_workitems - List work items with filters
create_workitem - Create a new work item
update_workitem - Update a work item
update_workitem_status - Change work item status
add_workitem_comment - Add a comment
list_workitem_comments - List comments
delete_workitem_comment - Delete a comment (soft delete, restorable within 30 days)
Trash (30-Day Recovery)
list_trash - List all work items in trash
restore_workitem - Restore a work item from trash
permanent_delete_workitem - Permanently delete from trash (irreversible)
empty_trash - Permanently delete all trashed items (irreversible)
Soft Delete
When you delete a work item, it moves to Trash and stays there for 30 days. During this period, you can restore it. After 30 days, items are automatically and permanently deleted.
Security Note
Keep your Personal Access Token secure. Never share it or commit it to version control. Treat it like a password.