Toki
Git-aware CLI todo manager with MCP server for AI agent integration
What is Toki?
Toki is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to git-aware cli todo manager with mcp server for ai agent integration
Git-aware CLI todo manager with MCP server for AI agent integration
This server falls under the Coding Agents and Developer Tools categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Git-aware CLI todo manager with MCP server for AI agent inte
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx tokiConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Toki
Toki is a Git-aware CLI todo manager written in Go that provides an MCP server for AI agent integration. It tracks tasks with git repository awareness, stores data in SQLite or Markdown files following XDG conventions, and exposes 11 tools, 7 resources, and 6 workflow prompts to Claude and other MCP-compatible agents for full CRUD task management.
Prerequisites
- Go 1.21 or later (for building from source), or a pre-built binary
- Claude Desktop or another MCP-compatible client
- git installed (toki uses git context for repository-aware task tracking)
- Optional: make (for building from source)
Install Toki
Install the toki binary using Go or build from source with make. The Go install method downloads and compiles the latest release automatically.
# Via Go
go install github.com/harperreed/toki/cmd/toki@latest
# From source
git clone https://github.com/harperreed/toki
cd toki
make installRun the setup wizard
Run toki setup to configure your preferred storage backend. New installations default to Markdown files stored at ~/.local/share/toki/. Existing users can choose SQLite for better performance with large task lists.
toki setup
# Interactive wizard asks:
# - Storage backend: SQLite or Markdown files
# - Data directory location (default: ~/.local/share/toki/)Create your first task
Verify the installation by adding a task from the command line. Toki automatically associates tasks with the current git repository when run from inside one.
toki add "Set up Toki MCP integration with Claude"
toki listConfigure the MCP server in Claude Desktop
Add the toki MCP server to your Claude Desktop configuration. The 'toki mcp' subcommand starts the MCP server over stdio. On macOS the config file is at ~/Library/Application Support/Claude/claude_desktop_config.json.
{
"mcpServers": {
"toki": {
"command": "toki",
"args": ["mcp"]
}
}
}Restart Claude Desktop and verify tools
Quit and relaunch Claude Desktop. Ask Claude to list your pending tasks. Claude will use the toki MCP tools to read from your local task database and display your current task list.
Toki Examples
Client configuration
Claude Desktop configuration to run toki as an MCP server via the mcp subcommand.
{
"mcpServers": {
"toki": {
"command": "toki",
"args": ["mcp"]
}
}
}Prompts to try
Example prompts to manage tasks through Claude using the Toki MCP server.
- "Show me all my overdue tasks and suggest which to prioritise today"
- "Create a project called 'Website Redesign' and add five initial tasks for the discovery phase"
- "Mark all tasks tagged 'review' as done and give me a summary of what was completed this sprint"Troubleshooting Toki
Claude Desktop cannot find the toki binary after installation
Ensure toki is on your PATH. Run 'which toki' in a terminal. If it prints a path, the issue is that Claude Desktop may not inherit your shell PATH. Set the full path in the config: "command": "/home/yourname/go/bin/toki"
Tasks created in toki CLI are not visible through the MCP server
Verify both the CLI and MCP server are using the same data directory. Run 'toki setup' to confirm the configured path. The default XDG path is ~/.local/share/toki/. Both processes must read from the same database file or Markdown directory.
toki mcp exits immediately when launched by Claude Desktop
Test the MCP server directly: run 'toki mcp' in a terminal and send a JSON-RPC handshake to stdin. If toki exits, check that the data directory exists and is writable. Running 'toki list' first will create any missing directory structure.
Frequently Asked Questions about Toki
What is Toki?
Toki is a Model Context Protocol (MCP) server that git-aware cli todo manager with mcp server for ai agent integration It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Toki?
Follow the installation instructions on the Toki GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Toki?
Toki works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Toki free to use?
Yes, Toki is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Toki Alternatives — Similar Coding Agents Servers
Looking for alternatives to Toki? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Toki in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Toki?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.