---
title: "Sharpy MCP server: a to-do list your agents can update"
description: "Claude Code, Codex, Cursor and ChatGPT read your to-do list, add tasks and mark them done through Sharpy’s local MCP server on your Mac. Setup and tools."
url: https://getsharpy.com/mcp
---

- [Sharpy](https://getsharpy.com/)
- [Use cases](https://getsharpy.com/use-cases/engineers)
- MCP server

# Sharpy’s MCP server: your to-do list for coding agents

Claude Code, Codex, Cursor and ChatGPT read your list, add tasks and mark them done through Sharpy’s local MCP server. It runs on your Mac, inside the Sharpy app.

[Download for Mac](https://getsharpy.com/download?get=1) [Windows waitlist](https://getsharpy.com/waitlist?platform=windows)

Free in early access. macOS 14 or later, Apple silicon.

## Set it up

### One click, from Sharpy

In Sharpy, open Integrations and add the client. Sharpy writes the entry into that client’s own config file, so there is nothing to paste.

- Claude Code
- Claude
- ChatGPT & Codex
- Cursor
- VS Code
- Windsurf
- Gemini CLI
- Zed
- OpenCode
- LM Studio
- Cline
- Roo Code

### By hand, in Claude Code

```
$ claude mcp add sharpy -- /Applications/Sharpy.app/Contents/Helpers/sharpy-mcp
```

Any client that speaks MCP over stdio takes the same helper: /Applications/Sharpy.app/Contents/Helpers/sharpy-mcp, with no arguments. Sharpy has to be running.

The first time a client connects, Sharpy asks on the island whether it may. The answer is kept per program, and you can revoke it in Integrations.

## What an agent can do

### Your list

Read what is on the list and what is next, add a task, rename one, move it or mark it done. One change, one undo.

- list_work
- add_work_item
- update_work_item
- wait_for_list_change

### What you were working on

Search what was on your screen, read the last few minutes or hours, open a call’s notes.

- search_memory
- get_recent_activity
- get_working_memory
- search_calls
- get_call

### Follow-ups

The promises and asks Sharpy found in your chats, mail and calls.

- list_followups

### Privacy controls

Pause capture, exclude an app or site, delete a stretch of history: the same switches as in Settings.

- pause_capture
- resume_capture
- add_exclusion
- list_exclusions
- delete_memory

## Questions

### Can Claude Code read my to-do list?

Yes. With Sharpy’s MCP server added, Claude Code can list your tasks, see what is next, add a task and mark one done when the work lands.

### Does my history leave the Mac when an agent reads it?

The server runs on your Mac and answers from the local file. What the agent pulls into its context goes wherever that agent sends its context; for Claude Code that is Anthropic’s API.

### Does it work with Cursor and ChatGPT?

Yes. Cursor reads the same helper from its MCP settings, and the ChatGPT desktop app uses Codex’s config, so “ChatGPT & Codex” in Sharpy sets up both.

### What about Todoist or Linear MCP?

Sharpy brings Todoist and Linear tasks into the same list, and done syncs both ways, so one MCP server covers all three.

[Sharpy for engineers](https://getsharpy.com/use-cases/engineers)

## Let Sharpy write tomorrow’s list.

[Download for Mac](https://getsharpy.com/download?get=1) [Windows waitlist](https://getsharpy.com/waitlist?platform=windows)

Free in early access. macOS 14 or later, Apple silicon.