Waymark
Query and edit Markdown work items, dependencies and trees in a Git repo
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 0.1.3
- Listing updated
- today
Similar MCP servers
About Waymark
Waymark is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Waymark keeps project work as Markdown files inside your Git repository, and this server lets an agent read and write that same project over stdio. There is no daemon, no database and no network access: the server finds the nearest .waymark/config.toml walking up from its start directory, or from a directory given with --project.
The tool set goes beyond create and list. Agents can fetch ready or blocked items, walk the parent tree or the dependency tree, set parents and soft links, transfer an owner, archive items, and edit configuration categories and custom fields. Diagnostic tools validate the project, run a doctor check, migrate version, schema or storage, and show git history and diffs.
Every success returns a versioned envelope with data and metadata; every business failure returns a stable error code, typed details and a retryable flag, so a client can tell a bad argument from a missing project or a concurrent edit. It is installed with cargo or from prebuilt Linux, macOS and Windows binaries, and is licensed MIT or Apache-2.0.
Install
Run in a terminal
claude mcp add waymark -- npx -y waymark-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"waymark": {
"command": "npx",
"args": [
"-y",
"waymark-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"waymark": {
"command": "npx",
"args": [
"-y",
"waymark-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"waymark": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"waymark-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"waymark": {
"command": "npx",
"args": [
"-y",
"waymark-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"waymark": {
"command": "npx",
"args": [
"-y",
"waymark-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (17)
Taken from the project documentation; the running server may differ.
- waymark_project_info
- Show project information.
- waymark_get_work_item
- Fetch one work item.
- waymark_list_work_items
- List work items.
- waymark_search_work_items
- Search work items.
- waymark_get_stats
- Get project statistics.
- waymark_get_tree
- Read the parent tree.
- waymark_get_dependency_tree
- Read the dependency tree.
- waymark_get_ready_items
- List items ready to start.
- waymark_get_blocked_items
- List blocked items.
- waymark_create_work_item
- Create a work item.
- waymark_set_status
- Set an item's status.
- waymark_add_dependency
- Add a dependency.
- waymark_archive_work_item
- Archive an item.
- waymark_validate
- Validate the project.
- waymark_doctor
- Run diagnostics.
- waymark_git_history
- Show git history.
- waymark_git_diff
- Show a git diff.
What it does
- Ready and blocked views
- List items that can start now or are waiting on others.
- Tree and dependencies
- Walk parent trees and dependency trees.
- Full item editing
- Create, retitle, rebody, status, move and archive items.
- Config management
- Add and change categories and custom fields.
- Git history
- Read history and diffs for work items.
- Structured errors
- Stable codes with a retryable flag.
Good for
- Let an agent pick the next unblocked task
- Create and link work items from a planning chat
- Audit dependencies before starting a feature
- Validate a project's work-item files
Pricing
Open source
MIT OR Apache-2.0
Waymark FAQ
Does it need a server or database?
No. It reads and writes Markdown files in your repo with no daemon, database or network access.
How do I install it?
cargo install waymark-mcp, or download a prebuilt binary from the releases page.
How does it find the project?
It walks up to the nearest .waymark/config.toml, or starts at the --project directory.
What licence?
MIT OR Apache-2.0.
Is Waymark free?
Yes. Waymark is open source, so you can use and self-host it for free.
How do I add Waymark to Claude Code?
Run this command in your terminal: claude mcp add waymark -- npx -y waymark-mcp
What are the best alternatives to Waymark?
The closest alternatives to Waymark are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


