Frequently Asked Questions about the Amazing Marvin MCP Server

Q: Is my data safe when using the MCP Server?

A: Absolutely! Your Amazing Marvin data remains exclusively between you, Amazing Marvin, and your chosen AI assistant. The MCP Server runs locally on your computer, ensuring a direct connection without any external server storage or third-party sharing.

Q: Which AI assistants are compatible with the MCP Server?

A: The MCP Server works with any AI assistant that supports the Model Context Protocol. This includes popular options like Claude Desktop, Cursor, VS Code, and Windsurf, with more being added regularly.

Q: What information from Amazing Marvin can my AI assistant access?

A: Your AI assistant gains access to a comprehensive view of your Amazing Marvin data, including your tasks, projects, categories, due dates, priorities, completion status, time tracking information, goals, labels, and organizational structure. Essentially, anything you can see within Amazing Marvin, your AI assistant can also access.

Q: Will using the MCP Server slow down my AI assistant?

A: The impact on performance is minimal. The MCP Server fetches data from Amazing Marvin only when you ask productivity-related questions. Response times depend on your internet connection, but are generally very quick.

Q: Can my AI assistant make changes to my tasks in Amazing Marvin?

Yes, if you explicitly instruct it to do so. Your AI assistant can create new tasks and projects, mark tasks as complete, start and stop time tracking, and organize tasks in batches. However, it will only make changes when you specifically request them.

Q: Can I view completed tasks through the MCP Server?

A: Yes! The MCP Server provides access to completed tasks through several methods:

• In Daily Focus View: See today’s completed tasks alongside pending ones, with completion counts and productivity notes.
• In Project Overviews: View completed vs. pending tasks separately, with completion rates and progress summaries.
• Historical Access: Retrieve completed tasks for specific dates or time ranges.

Q: What actions can’t the MCP Server perform?

A: The MCP Server has some limitations:

• It cannot delete or remove tasks, projects, categories, labels, or goals.
• It cannot edit existing task content (title, notes, due dates) or move tasks between projects.
• It has limited access to historical completed task archives, detailed time tracking reports, private notes, or advanced Amazing Marvin features.

Q: How frequently is the data updated in the MCP Server?

Data is fetched in real-time with each request to the Amazing Marvin API, ensuring you always have the most current information. There is no background syncing or caching, so you’re always working with the latest data from your Amazing Marvin account.

Q: I’m encountering an “API key not found” error. How can I resolve this?

A: This error indicates that the MCP Server cannot locate your Amazing Marvin API key. Here’s how to troubleshoot it:

• Verify that your API key is correct in Amazing Marvin’s Settings → API section.
• Check the environment variable (e.g., by running echo $AMAZING_MARVIN_API_KEY in your terminal).
• Restart your AI client after setting the API key.
• Ensure there are no extra spaces in your API key.

Q: I’m seeing “Connection refused” or timeout errors. What should I do?

A: These errors suggest a problem connecting to the Amazing Marvin API. Try the following:

• Check your internet connection.
• Verify the Amazing Marvin service status.
• Run a connection test using the provided Python command.
• Check if you are behind a corporate firewall that may be blocking the connection.

Q: My AI assistant says it doesn’t see any Amazing Marvin data. What’s wrong?

A: This may indicate that the MCP Server is running but not returning data. Try these solutions:

• Ask your AI assistant explicitly to use the Amazing Marvin tool to retrieve your tasks.
• Ensure you have tasks in your Amazing Marvin account.
• Verify the API permissions in your Amazing Marvin settings.
• Restart your AI client.

Q: I’m getting a “Python module not found” error. How can I fix this?

A: This error indicates that the amazing_marvin_mcp module is not installed correctly. Try these steps:

• Reinstall the module using pip install --force-reinstall amazing-marvin-mcp.
• Check your Python path using python -c "import sys; print(sys.path)".
• Use the full path to your Python executable in your configuration.