shar8 MCP server
Commit Nov 8, 2026Enables AI agents to read, execute, and report back on tasks from a personal task manager via MCP.
Also known as triumphpc/shar8-agent, shar8-agent
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 8, 2026
- License
- MIT
What is shar8 MCP?
shar8 enables AI agents to read, execute, and report back on tasks from a personal task manager via MCP.
Summary generated from the project's README
About shar8 MCP server
Automating personal task management by delegating work to Claude Code is what shar8 enables. Users mark specific tasks as "Агенту" in the shar8.app task manager, and this MCP server picks them up to run local processes on your machine. The agent processes the task and writes the results directly back into your task notes, updating the status to either "На проверке" or "Нужно уточнение" for your final review.
This setup runs locally using either your existing Claude Code subscription or a personal ANTHROPIC_API_KEY. It connects to the task manager via MCP over HTTPS using a personal token. To maintain security, the agent starts with no tools and cannot send data outward unless you explicitly define an allow-list in a send-policy.json file. You can also opt-in to specific capabilities like web search by configuring an agent.json file.
Each execution pass is limited to three tasks, a fifteen-minute duration, and a two-dollar budget per task. While the plugin is specifically designed for Claude Code, other clients like OpenCode or Codex CLI can connect to the service using your token.
What you can do with it
- 1Automated task executionHand an AI agent a task from your personal manager to run locally on your computer.
- 2Scheduled workflow managementSet up a recurring schedule to have an agent check for and process new delegated tasks.
- 3Controlled agent permissionsRestrict an agent to only specific tools like reading files or performing web searches.
- 4Secure task delegationEnsure that the agent only communicates with approved destinations to prevent unauthorized data transfer.
Written from the project's README. Every use case is checked against a quote from it.
How to install shar8 MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall shar8 MCP in Claude Code
$ claude mcp add --transport http shar8-agent https://shar8.app/mcpInstall shar8 MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"shar8-agent": {
"url": "https://shar8.app/mcp"
}
}
}Install shar8 MCP in VS Code
.vscode/mcp.json
{
"servers": {
"shar8-agent": {
"type": "http",
"url": "https://shar8.app/mcp"
}
}
}Install shar8 MCP in VS Code CLI
$ code --add-mcp '{"name":"shar8-agent","type":"http","url":"https://shar8.app/mcp"}'Install shar8 MCP in Codex
$ codex mcp add shar8-agent --url https://shar8.app/mcpInstall shar8 MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.shar8-agent] url = "https://shar8.app/mcp"
Install shar8 MCP in Gemini CLI
$ gemini mcp add -s user --transport http shar8-agent https://shar8.app/mcpInstall shar8 MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"shar8-agent": {
"url": "https://shar8.app/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachabletriumphpc/shar8-agent is public and reachablegithub.com/triumphpc/shar8-agent ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-08github.com/triumphpc/shar8-agent ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubshar8-agent
A Claude Code plugin that lets an agent work through your task list on a schedule.
You mark a task "Агенту" (For the agent) in shar8.app, a personal task manager with an MCP server. The plugin picks the task up over MCP, runs Claude Code locally on your machine, and writes the result back into the task notes. The task status becomes "На проверке" (needs review) or "Нужно уточнение" (needs your answer). Only you close the task. If no task is delegated, the model is not called at all.
- Runs on your own Claude Code subscription or on your own
ANTHROPIC_API_KEY. You choose the mode during install; there is no default. - The only channel to shar8 is MCP over HTTPS with your personal token. The plugin has no other network addresses.
- By default the agent has no tools: it sees the task text and answers with text. Web search or other MCP servers are opt-in through
~/.config/shar8-agent/agent.json. - Sending anything outward (chat messages, mail) is off unless you describe an allow-list in
send-policy.json.
Full documentation (Russian): plugin/README.md. Landing page: shar8.app/for-agents.
Install (Claude Code)
Requirements: Claude Code 2.1.308 or newer, Node.js 20 or newer, a personal shar8 token (cabinet, "Выдать токен"; shown once).
claude plugin marketplace add triumphpc/shar8-agent
claude plugin install shar8-agent@shar8
Then, in a Claude Code session, run /shar8-agent:install and paste the printed line into a terminal. The slash command only prints the line, so the token never passes through the model. If the slash command is unavailable, run node "<installPath>/bin/shar8-agent.mjs" install, where <installPath> is the plugin path from claude plugin list --json.
The installer asks for the server address (Enter keeps the default https://shar8.app/mcp), the token (hidden input), the model mode and whether to set up a schedule (default: once a minute). At the end it makes a probe run of claude and says plainly if the probe failed.
Manage and update:
node ~/.config/shar8-agent/shim.mjs status
node ~/.config/shar8-agent/shim.mjs run
node ~/.config/shar8-agent/shim.mjs uninstall
claude plugin marketplace update shar8
claude plugin update shar8-agent@shar8
Supported systems (honest status)
| System | Status |
|---|---|
| macOS | Verified live on 2026-11-02: real shar8.app, real Claude Code, scheduled by launchd on a subscription; a delegated task was picked up within a minute and returned a report. |
| Linux | Implemented (systemd user timer), checked with files and fakes. Not run live yet. |
| Windows | Beta. Implemented (Task Scheduler), not verified live. |
Other MCP clients (OpenCode, Codex CLI) can connect to shar8 by token without this plugin; see the landing page above. This plugin itself targets Claude Code only.
Security notes
- The agent sees all tasks you delegated to it, in full: title, notes, subtasks. Delegate only what you are fine sending to the model you chose.
- The token is typed with hidden input and stored only in
~/.config/shar8-agent/env(mode 0600). It is not passed through command-line arguments,settings.jsonor~/.claude.json, and not written to logs. clauderuns isolated: an empty tool list by default,--permission-mode dontAsk, MCP servers only from youragent.json, an allow-listed environment. Built-in tools inagent.jsonare limited toRead,Glob,Grep;Bash,Write,EditandWebFetchare closed so the agent cannot read the token file.- Limits per run: up to 3 tasks per pass, 15 minutes and a 2.00 USD budget per task.
uninstallremoves the schedule and keeps the token;uninstall --purgealso removes the env file.
License
MIT, see LICENSE.
shar8-agent (по-русски)
Плагин Claude Code, который по расписанию разбирает ваши задачи в shar8.app.
Вы ставите в задаче пометку «Агенту». Плагин забирает её по MCP, запускает Claude Code локально на вашем компьютере и кладёт результат в заметки задачи. Статус станет «На проверке» или «Нужно уточнение», закрываете задачу только вы. Если делегированных задач нет, модель не вызывается.
Установка:
claude plugin marketplace add triumphpc/shar8-agent
claude plugin install shar8-agent@shar8
Дальше в сессии Claude Code выполните /shar8-agent:install и вставьте напечатанную строку в терминал. Модель работает на вашей подписке Claude Code или на вашем ключе ANTHROPIC_API_KEY.
Статус систем: Mac проверен вживую 2 ноября 2026; Linux реализован, вживую не проверен; Windows в beta.
Безопасность: агент видит все делегированные ему задачи целиком. Токен хранится только в файле с правами 0600 и не попадает в аргументы команд и логи. По умолчанию у агента нет инструментов и он ничего не отправляет наружу. Подробности и полная документация: plugin/README.md.
Лицензия: MIT.
shar8 MCP questions
How do I add shar8 MCP to Claude Code?
Run claude mcp add --transport http shar8-agent https://shar8.app/mcp in your terminal. Add --scope user to make it available in every project.
How do I add shar8 MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How does the agent access my tasks?
The agent connects to shar8 via MCP over HTTPS using a personal token.
Does the agent have access to my tools by default?
No, the agent starts with no tools and only sees the task text. Web search or other MCP servers must be explicitly enabled in the configuration.
Can the agent send emails or chat messages?
Outward communication like chat or mail is disabled unless you define an allow-list in the send-policy.json file.
What are the execution limits for the agent?
Each run is limited to up to 3 tasks, a duration of 15 minutes, and a budget of 2.00 USD per task.