MCP Server
in progress
Jeff Vermeire
Develop an MCP server for agentic workflows. As more and more work moves toward AI-centric development and processing, agents are used extensively to automate and speed tasks. An MCP server would allow code editors like Cursor and Windsurf to directly interface with Sunsama and automatically manage tasks and schedules based on how and when tasks are completed. As more products move into agentic workflows, and more tools provide their own MCP servers, Sunsama is going to need this in order to keep up/stay ahead of other tools.
Alicja Baran
While the team solves the problem with ResourceTemplate not being supported by many clients, claude code added this for me to MEMORY.md: - Get tasks for a specific day: use ReadMcpResourceTool with server sunsama and URI sunsama://tasks/YYYY-MM-DD (resource template — not visible in ListMcpResourcesTool, call directly). With this it's getting the tasks for a specific day without any issues. Maybe you can apply this workaround in your solutions as well
Vincent D'Amico
Zane Mccaig Is there anyway you will add a way so we can attach it without a bearer token since Claude doesn't allow this currently? with the simple connector at least?
Zane Mccaig
Vincent D'Amico Yes I am working on OAuth right now. We will also likely try and get one click installs implemented for the bigger services
Jeffrey Bui
Is the MCP server live?
If so - I will switch back to Sunsama
Zane Mccaig
Jeffrey Bui: Yes it is. It is still in early beta though so we are ironing out a few kinks
Alicja Baran
Zane Mccaig qq, can we get somehow the information on how much time we have spent on a task? right now I get the response on how much time was the task estimated for, but is it possible to get the info as well on the real time spent?
Zane Mccaig
Alicja Baran we do not have that added in yet but I will put it into our backlog.
Alicja Baran
While the team solves the problem with ResourceTemplate not being supported by many clients, claude code added this for me to MEMORY.md: - Get tasks for a specific day: use ReadMcpResourceTool with server sunsama and URI sunsama://tasks/YYYY-MM-DD (resource template — not visible in ListMcpResourcesTool, call directly). With this it's getting the tasks for a specific day without any issues. Maybe you can apply this workaround in your solutions as well
Zane Mccaig
Alicja Baran Thanks for chiming in with this. That is a really useful workaround.
Andrew Kippen
Nice work guys. I was able to set up the MCP server within Claude Code. Then I was able to copy a task from Asana over to Sunsama.
My plan is to use Claude as a project manager who can track big picture items in Asana, while using Sunsama for weekly/daily things. Excited about the integration and I agree that having an oAuth implementation would make further integration easier. For the moment this is a win though - thanks!
Mike O
Huge thanks for shipping the MCP server. We resumed our planning/workflow build around it and did a first deep pass inventory today. Some thoughts:
- Deterministic daily task retrieval
Please add
get_tasks_for_day(day)
and get_today_tasks()
with filters (includeCompleted
, includeBacklog
, includeArchived
) and stable sorting. We kludged it with search_tasks
but it was hugely expensive, slow and not reliable.- Objective read/update parity
Please add
list_objectives
, get_objective
, update_objective
, and archive/delete objective so objective workflows are fully MCP-capable (not just align/create). I like this middle-tier object between projects and tasks; i want to leverage it with my agents.- Incremental sync model
Please add “changes since cursor” (including tombstones) so agents can sync safely without rescans/search hacks.
- Webhook/event support
Please expose push events for task/objective/calendar changes. Polling-only is expensive and brittle for agent workflows.
- Idempotency + conflict controls
Please support idempotency keys and optimistic concurrency (
version
/etag
) for safe retries and multi-agent edits.Zane Mccaig
Mike O We have several of these things available as
resources
and resource templates
right now. It seems lots of clients do not support resources and/or resource templates which is a shame. We set them up for our voice service and used the MCP resource subscriptions to keep things up to date.Subscriptions won't work via the HTTP connection mode but we actually currently also support websocket connections. Websocket transports never really caught on but there are a few libs that support them and that is what we used for our voice service. We will likely leave the websocket mode active while we iterate and improve things over the coming months. If we end up implementing SSE it might not be necessary anymore though so perhaps it will be removed.
Mike O
- Bulk operations
Please add batch create/update/move/complete endpoints for weekly planning workflows and lower tool-call overhead.
- Error + rate-limit contract
Please document machine-readable error codes and rate-limit headers (
Retry-After
, remaining quota) so automations can recover correctly.- Scoped auth permissions
Please support read-only vs write scopes (ideally granular by domain) for safer agent deployments.
- Canonical MCP docs + changelog
Please publish complete tool/resource schemas, required headers, examples, and a versioned changelog for breaking changes.
Note: Ashutosh already mentioned OAuth/help-center docs are planned (“once we add OAuth and work out a few more kinks”). Thank you. This request is to prioritize an interim capability matrix + changelog so client builders can ship reliably now.
These items directly unlock daily planning, shutdown, weekly planning/review, and focus-mode execution in conversational workflows.
Next: migrate my Parking-Lot.json into backlog and make Sunsama my canonical corpus for driving an "execution mode" via my conversational agent.
Thought-bubble: could I leverage Sunsama to map and keep track of side-branch ideas that come up during my main conversation -- in backlog items. Sunsama's FOCUS mode can help keep the primary objective of a conversation front and center while allowing me to document side-ideas as they come up without falling down a rabbit hole. see? like this paragraph! :P
Zane Mccaig
marked this post as
in progress
Zane Mccaig
We just launched our MCP server in public beta. Please go to your Sunsama settings page to get started with it. Feel free to ping us in our support channel to let us know what you think and if you run into any issues with it.
Ben Woodward
Zane Mccaig just enabled it, and when i try to connect in Claude Desktop i get this error. using https://api.sunsama.com/mcp as the URL, Claude asks for OAuth Client ID and secret which Sunsama doesn't give me, just a bearer token.
Rick Montero
Zane Mccaig *found MCP option. In Settings > Integrations > MCP
Zane Mccaig
Ben Woodward: We currently only have a basic token based authentication. It appears that Claude Desktop requires the full OAuth authentication to connect to a remote server.
You could try writing a small wrapper MCP proxy that runs locally for STDIO and then it could pass requests back and forth to our MCP server but that is a bit annoying. We will bump OAuth support up in our priority list since both Claude Desktop and ChatGPT require it.
Teemu Turpeinen
Ben Woodward On a macOS, you can configure the mcp server in
~/Library/Application Support/Claude/claude_desktop_config.json
for example like below"mcpServers": {
"Sunsama": {
"command": "/usr/local/bin/npx",
"args": [
"mcp-remote@latest",
"https://api.sunsama.com/mcp",
"--header",
"Authorization: Bearer your_token"
]
}
}
You need to have node installed. Works well on Claude Desktop and Cowork too.
Ben Woodward
Teemu Turpeinen thanks. for anyone using
asdf
you will need to use this command value: "command": "/Users/<your username>/.asdf/shims/npx",
Ben Woodward
Zane Mccaig would be great to be able to query for tasks by date, doesn't seem to be possible to "list today's tasks"
Dmitry Sumin
Zane Mccaig I don't think it is now possible to get task list for a date (today, tomorrow).
That's critical for using MCP.
That was implemented in https://github.com/robertn702/mcp-sunsama
Zane Mccaig
Ben Woodward Dmitry Sumin I am not sure why it struggled to find it but the resource template is called get_tasks_for_day
Dmitry Sumin
Zane Mccaig I'm afraid get_tasks_for_day is missing from the output of
tools/list
: curl -s -X POST https://api.sunsama.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Authorization: Bearer $AUTH_TOKEN" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | python3 -m json.tool
Cole Morgan
Zane Mccaig I just tried calling get_tasks_for_day and get_tasks_by_day completely bypassing the printed listing, but the API specifically threw an error that the "Tool is not found." The server is strictly rejecting them.
Zane Mccaig
Dmitry Sumin and Cole Morgan it is a
resource template
not a tool call. It seems that lots of providers may not use or support resource templates though which is unfortunate. We are working on adding OAuth support right now but once that is done I will prioritize this to figure out why resource templates are not being picked up. What LLM providers / services are you guys trying to connect to Sunsama with?Cole Morgan
Zane Mccaig I'm using this with my OpenClaw and using MiniMax M2.5, Gemini 3 Flash, or Kimi K2.5
Zane Mccaig
Cole Morgan Thanks Cole. It looks like OpenClaw only supports tools right now and not resources or resource templates which limits how much you can read from our MCP server right now. Once I pick up this task I will see if there are simple workarounds that I can document somewhere.
I am sure someone has built wrapper mcp servers that can convert resources to tools I am just not sure what that setup looks like right now. If anyone else has experience with mcp server wrappers and knows how to do this right now. Perhaps Teemu Turpeinen has run across this before?
Teemu Turpeinen
Zane Mccaig unfortunately not, but FastMCP might have something for this use case. I have no experience in using this though.
Tom Solid
Zane Mccaig I can confirm. Login auth not working
Zane Mccaig
Tom Solid Which client are you trying to connect with. Did you specify that it was
http
and not SSE?Dmitry Sumin
Zane Mccaig I'm using Claude Desktop
Maksym Kulia
Now that AI tools are moving SO fast MCP server is really a must for Productivity tools.
Do you have any ETA when it will be ready?
Load More
→