# Plane MCP for AI Agents AI Agent Connect > Plane MCP. Manage Plane.so projects, track issues, review sprint cycles, and audit agile modules completely autonomously. This integration lets your AI agent pull project architectures, analyze development cycles, and parse active issue pipelines without you having to navigate kanban boards manually. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_JKhdKYJDP25kJTYdQUGpXsbfCZz7sthr9OpDTwzO/ai-agent-connect - **Tags:** agile, issue-tracking, kanban, sprint-management, open-source, software-engineering ## Description This Connector gives your AI agent a direct line into your Plane workspace. Instead of clicking through multiple boards to see what is happening, your agent can just grab the data. It pulls project architectures, checks out your active development cycles, and digs into the issues your team is actually working on. If you are trying to get a clear picture of your sprint progress without the manual overhead, this is how you do it. You can find this and thousands of other integrations in the Vinkius catalog to keep your tools connected. It works whether you are on Plane Cloud or running your own instance. You just point the agent at your workspace and let it handle the heavy lifting of parsing your roadmap. It lets you stay in your flow while your agent handles the tedious task of data retrieval. ## Tools ### get_project Gets specific details of a Plane project. It pulls the high-fidelity descriptions and status parameters you need. ### list_work_items Lists work items or issues inside a Plane project. Use this to see exactly what tickets are in the pipeline. ### list_cycles Lists all cycles within a specific Plane project. Use this to see what is currently in development. ### list_modules Lists the modules inside a Plane project. It helps you see the high-level epics your team is tackling. ### list_labels Lists all project labels in Plane. This is great for checking your categorization taxonomy. ### list_projects Lists all projects in a Plane workspace. Use this to get a bird's eye view of your entire workspace. ## Prompt Examples **Prompt:** ``` What's the status of our current sprint? ``` **Response:** ``` I've checked the cycle `v1.2 Release`. Out of 15 mapped items, 4 are still unresolved. The `Database Race Condition` ticket is currently 'In Progress' by the QA team. Would you like me to pull the details for that specific ticket? ``` **Prompt:** ``` List the modules for project-x. ``` **Response:** ``` I found 4 distinct modules for the 'Frontend Rewrite' project: `Auth Module`, `Kanban Redesign`, `API Rate Limiter`, and `User Onboarding`. The `Auth Module` is scheduled for completion by October 20th. ``` **Prompt:** ``` Get the requirements for issue 3841-A. ``` **Response:** ``` I've pulled the data for `3841-A`. Title: `Handle missing env parameters explicitly during build steps`. It's tagged as 'High Priority' and 'DevOps'. The requirements call for an abort sequence during CI initialization if variables are missing. ``` ## Capabilities ### Fetch project architectures Get high-level descriptions and status parameters for every project in your workspace. ### List active development cycles See all current sprints and their completion statuses in one go. ### Scan engineering tasks Pull every ticket and work item from specific issue pipelines. ### Read epics and modules Access the high-level modules and labels that organize your work. ### Audit project labels Review your taxonomy to ensure consistent categorization across the team. ## Use Cases ### Summarizing a stalled sprint The sprint is stalling. Ask your agent to list all cycles and summarize the completion status of the current development cycle. ### Checking feature scope You need to know the scope of a new feature. Use list_modules to see the high-level epics and labels for the project. ### Reviewing ticket requirements You are stuck on a bug. Ask your agent to pull the exact details of a specific issue to see the raw content and requirements. ### Auditing the backlog You are auditing the backlog. Use list_work_items to perform a deep sweep of all tasks in a specific project boundary. ## Benefits - Stop manual status checks by using list_cycles to get instant sprint overviews. - Keep your focus on code by using list_work_items to inspect the backlog from your IDE. - Audit your roadmap easily with list_modules to ensure your epics align with goals. - Maintain a clean taxonomy by using list_labels to check for consistent naming. - Get a workspace overview quickly with list_projects to see every active initiative. - Save time on meetings by using get_project to pull high-fidelity descriptions for stakeholders. ## How It Works The bottom line is you get direct data access to your agile workspace without the manual navigation. 1. Install this Connector onto your preferred AI client. 2. Provide your Plane Personal API Key and your self-hosted API URL if applicable. 3. Start querying your projects, cycles, and work items immediately. ## Frequently Asked Questions **Can the Plane MCP help me summarize my sprint progress?** Yes, it pulls your current cycle data and work items so your AI can give you a quick summary of what is finished and what is still pending. **How does the Plane MCP help with project management?** It lets your AI agent read your projects, modules, and labels to help you organize work and understand your roadmap without opening the app. **Can I use Plane MCP to see my engineering tickets?** Yes, the Connector can list all work items inside a project, allowing your agent to scan the backlog for specific tasks or issues. **Will the Plane MCP work with my self-hosted Plane instance?** Yes, you can provide your own self-hosted API URL along with your personal API key during the setup process. **Can I use Plane MCP to audit my project labels?** Yes, it can list all labels in your project, making it easy for your agent to check your taxonomy for consistency. **Does the Plane MCP require a specific AI client?** No, it works with any MCP-compatible client, including Claude, Cursor, and Windsurf. **Can I use Plane MCP to see my project modules?** Yes, it can pull the high-level modules and epics for your projects so you can see the bigger picture of your engineering work. **Can my AI automatically aggregate all open issues inside our active sprint?** Yes. First, request the active iteration window by calling `list_cycles`. The agent will isolate today's active cycle bounds. Following that, it will invoke `list_work_items` directly constrained by that cycle object, outputting an exhaustive summary of untouched or blocking tickets. **How does the agent handle custom workspace slugs or self-hosted URLs?** The system dynamically accepts a `PLANE_BASE_URL` credential. If you are doing an on-premise installation running inside your homelab or company AWS cloud, you merely inject your private domain (e.g., `https://plane.internal.acme.com`). The workspace slug is seamlessly accepted as a contextual execution parameter during standard query prompts. **Can I request specific details of a long-term module (epic)?** You can instruct the agent to execute `list_modules`. It extracts the cross-functional epics spanning your workspace project. Your AI can read these top-level module architectures to contextually understand what the core functionality of the project repository aims to achieve.