io.github.paulbreuler/limps

skills

MCP planning server for AI agents — plan management, full-text search, and task lifecycle

10 16.6M/wk 14 tools GitHub npm

No known CVEs

No license

Maintained

Last commit 121d ago

Works with most clients

Transport: stdio, sse, http

14 tools · ~522 tok

Grade B · 0.3% of 200K ctx

Edit this pageView history

AI / ML Productivity

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "limps-planning-myproject": {
      "transport": {
        "url": "http://127.0.0.1:4269/mcp",
        "type": "http"
      }
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-paulbreuler-limps)](https://mcppedia.org/s/io-github-paulbreuler-limps)

Read me

What io.github.paulbreuler/limps does

Local Intelligent MCP Planning Server — A document and planning layer for AI assistants. No subscriptions, no cloud. Point limps at any folder (local, synced, or in git). One shared source of truth across Claude, Cursor, Codex, and any MCP-compatible tool.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'skills' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

81/100across 5 weighted dimensions

How we score →

0255075100

−19

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked skills against OSV.dev.

Inventory

Tools (14)

Click any tool to inspect its schema.

~522 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.paulbreuler/limps safe to use?: io.github.paulbreuler/limps has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.paulbreuler/limps?: io.github.paulbreuler/limps supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.paulbreuler/limps do?: io.github.paulbreuler/limps provides 14 tools: create_plan, create_doc, list_plans, list_agents, list_docs and 9 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.paulbreuler/limps?: io.github.paulbreuler/limps is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is io.github.paulbreuler/limps actively maintained?: io.github.paulbreuler/limps is less actively maintained — last commit was 121 days ago. It has 10 GitHub stars.

Similar servers

Others in ai-ml / productivity

View all →

Sequential Thinking MCP Server98

Dynamic problem-solving through sequential thought chains

87.9k 1

Memory MCP Server98

Persistent memory using a knowledge graph

87.9k 5

Gpt Researcher95

An autonomous agent that conducts deep research on any data using any LLM providers

28.0k 5

Ruflo95

🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, distributed swarm intelligence, RAG integration, and native Claude Code / Codex Integration

62.3k 4

MCP Security Weekly

Get CVE alerts and security updates for io.github.paulbreuler/limps and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Quick Start

# Install globally npm install -g @sudosandwich/limps # Initialize in your project cd ~/Documents/my-planning-docs limps init # Start the HTTP daemon limps server start # → Daemon starts on http://127.0.0.1:4269/mcp # → PID file written to OS-standard location # → Ready for MCP client connections # Generate MCP client config limps config print --client claude-code # Copy the output to your MCP client config file

That's it. Your AI assistant now has access to your documents via HTTP transport. The folder can be anywhere—local, synced, or in a repo; limps does not require a git repository or a plans/ directory.

Tip: limps server status always includes system-wide daemon discovery. If a project config is found (or passed via --config), it also reconciles the configured project target against that global list.

Features

Document CRUD + full-text search across any folder of Markdown files

Plan + agent workflows with status tracking and task scoring

Next-task suggestions with score breakdowns and bias tuning

Sandboxed document processing via process_doc(s) helpers

Multi-client support for Cursor, Claude, Codex, and more

Extensions for domain-specific tooling (e.g., limps-headless)

Knowledge graph — Entity extraction, hybrid retrieval, conflict detection, and graph-based suggestions

Health automation — Staleness detection, code drift checks, status inference, and auto-fix proposals

Advanced task scoring — Dependency-aware prioritization with per-plan/agent weight overrides

MCP Registry — Published to the official MCP Registry (registry.modelcontextprotocol.io)

What to know before you start

Local only — Your data stays on disk (SQLite index + your files). No cloud, no subscription.

Restart after changes — If you change the indexed folder or config, restart the MCP server (or rely on the file watcher) so the index and tools reflect the current state.

Daemon management — The HTTP server runs as a background process. Use limps server start, limps server stop, and limps server status to manage the daemon lifecycl

Frequently Asked Questions

Is io.github.paulbreuler/limps safe to use?

io.github.paulbreuler/limps has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install io.github.paulbreuler/limps?

io.github.paulbreuler/limps supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can io.github.paulbreuler/limps do?

io.github.paulbreuler/limps provides 14 tools: create_plan, create_doc, list_plans, list_agents, list_docs and 9 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with io.github.paulbreuler/limps?

io.github.paulbreuler/limps is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.

Is io.github.paulbreuler/limps actively maintained?

io.github.paulbreuler/limps is less actively maintained — last commit was 121 days ago. It has 10 GitHub stars.